Automation

シェルが黙って間違える仕組み

片づけ用のスクリプトが、9本のプロセスを落とすはずが、1本も落とさないまま『9本とも終了済み』と報告しました。エラーは、一つも出ていません。zshとbashで空白の扱いが違うことと、kill が失敗したときに「already gone」と出すフォールバックの一行が重なっていました。

2026.10.11 公開読むのに約 7分約 4,000字
この記事の内容
  1. 変数の直後に置く全角の罠
  2. zshと変数の空白分割
  3. 無いコマンドを呼んだときの取り違え
  4. 『ゼロ件』の二つの意味
  5. bash -n が見つけてくれないもの
  6. set -u を入れておく効果
  7. 状態変更のあとの数え直し

設定を書き換える apply_settings.sh が変更表を出す直前で止まり、別の片づけ用のスクリプトは冒頭に書いたとおり9本のうち1本も落とさずに終了済みと報告しました。エラーで止まるぶんにはまだ気づけますが、エラーも出さずに最後まで走る間違いは画面だけでは成功と見分けがつきません。手元の自動化でこういう失敗を三つ踏んでいて、一つ目は途中で止まりましたが、残りの二つは最後まで走り切り、結果だけが間違っていました。

変数の直後に置く全角の罠

一つ目は日本語混じりのスクリプトでよく出る問題で、変数を画面に出すときに $VAR と書いて直後に全角の文字を続けるとおかしくなりました。シェルは $ のあとの変数名の区切りをバイト単位で探し、英数字やアンダースコアが続くあいだは名前の一部とみなして、それ以外の文字が来たところで切ります。しかし全角の文字は環境によってはこの区切りとして扱われず、名前の続きとして読まれることがあります。たとえば画面に「結果(確定)」と出したくて $KEKKA(確定) と書くと、シェルは KEKKA(確定) という別名の変数を読みにいきます。未定義の変数を参照したら止める set -u を入れていれば、その行で unbound variable を出して止まります。対策は変数を ${KEKKA} と波括弧で囲むだけで、変数名の区切りがはっきりして直後が全角でも正しく展開されます。

構文としては正しいので、構文チェックの bash -n では引っかかりません。実際、apply_settings.sh と sort_by_month.sh の2本に、この形が合わせて8か所潜んでいました。どれも画面に出す文字列の中で、囲み忘れた一か所を踏むまで、残りは何事もなく動いていました。全角の句点も同様で、「$VAR。」と書けば、句点まで名前として読まれることがあります。半角の空白やハイフンなら名前はそこで切れるので、気をつけるのは日本語を続ける行だけで足ります。だから、日本語を出す行は、最初から波括弧で囲む癖をつけました。

書き方シェルの解釈
$KEKKA(確定)KEKKA(確定)という別名を読み、未定義で停止
${KEKKA}(確定)KEKKA を展開し、(確定)はただの文字列として続く
変数の直後に全角文字を置くときは、波括弧で変数名の区切りをはっきりさせる。

zshと変数の空白分割

二つ目は、bashの癖のままzshで書いたときに出ました。bashは変数展開の結果を空白で単語分割するので、T="a b c" を for p in $T に渡すとループは3回まわり、pにはaとbとcが順に入ります。zshは変数展開の結果を空白で分割しません。同じ書き方でもループは1回で終わり、pには "a b c" という一つの文字列がまるごと入ります。これを知らずに、放置されたプロセス9本のPIDを空白区切りで入れた変数を、for p in ${TARGETS}; do kill -TERM "$p" ... に渡していました。kill が受け取ったのはPIDを空白でつないだ一つの文字列で、1本も終了しません。そのうえ kill が失敗したときのフォールバックに || echo "already gone" を付けていたため、失敗はこの echo に吸われ、9本とも終了済みという報告に化けました。zshで空白区切りを効かせたいときは、${=T} と書くか、PIDをベタ書きします。kill のような副作用のあるループは、実行後に ps でプロセスの数を数え直すことにしました。この件も、psで数えてはじめて1本も落ちていないと分かりました。macOSはCatalina(10.15)から標準のシェルがzshなので、bashの前提で書いた行をこのMacでそのまま流すと、同じずれが起きます。

無いコマンドを呼んだときの取り違え

3つ目は、環境に無いコマンドを呼んだときに起こります。この Mac には処理を時間で打ち切る timeout も gtimeout も入っておらず、coreutils が未導入のままになっています。うっかり timeout 60 find ... と書くと command not found になり、終了コード 127 が返りますが、これだけなら気づけます。しかし出力をパイプで wc -l に渡して行数にしたり、|| echo なし で受けたりすると、画面には 0 や「なし」とだけ表示されました。失敗したという事実が件数 0 や「なし」といった、いかにも正常に見える結果にすり替わってしまいます。実際、保存先の全体を探す確認がこれで「どこにも無い」と誤報し、別のエージェントが気づくまで結論が 1つ間違ったまま残りました。

ログを読むときの log も同様に化けます。このMacのzshでは log がシェル側に奪われており、type log で確認できます。この状態で log show --predicate ... を実行すると (eval):log:1: too many arguments を吐くか、黙って0行を返すだけになります。今回の診断では3つのエージェントがそれぞれこの罠を踏み、3つとも最初は「該当ログなし」と報告しました。/usr/bin/log とフルパスで書けば、本物の log が呼ばれます。

タイムアウトさせたいときは、環境に無いコマンドを当てにせず、呼び出す側で時間を区切ります。具体的には、エージェントが使う Bash ツールの timeout パラメータ(ミリ秒)で外から打ち切るか、シェルの中なら perl -e で alarm 60 を仕掛けてから exec で本体のコマンドを起動する書き方を採用しました。perl は macOS に最初から入っているので、別の Mac へ持っていっても共通の書き方で打ち切れます。

書いたつもり実際に起きること
無いコマンド | wc -l失敗が『0』という件数にすり替わる
無いコマンド || echo なし失敗が『なし』という答えにすり替わる
log show ...(zshのまま)zshの組み込みコマンドが呼ばれて、空の結果が返る
失敗を受け流す書き方は、エラーを正常な結果に変えてしまう。終了コードを先に見る。

『ゼロ件』の二つの意味

二つ目と三つ目は、失敗を受け流した already gone や 0、空の出力を、正しい結果だと思い込んだ失敗です。0件や「なし」や空の出力には、二つの意味があります。探した結果として本当に無かった場合と、そもそも処理が走っていなかった場合です。出力だけではこの二つの見分けがつかないので、終了コードを見ます。コマンドを一本ずつ区切って $? を確かめ、127や想定外の値が返っていないかを見ます。パイプでつなぐなら set -o pipefail を入れると、途中のコマンドが失敗したときにその終了コードがパイプライン全体の値になり、最後の wc -l の成功で上書きされません。副作用のある処理では、終了コードに加えて、実行後の件数も元の数と突き合わせます。

bash -n が見つけてくれないもの

ここまでの 3つは、どれも実行前の構文チェック(bash -n)では検出できませんでした。構文チェックが見るのは構文として正しいかどうかだけなので、波括弧を忘れた変数も、zsh での空白の扱いも、環境にコマンドがあるかどうかも、構文としては正しいため素通りしてしまいます。残る手は、実際に走らせて結果を数えるか、あやしいパターンを先に洗い出すかのどちらかでした。波括弧なしの変数で直後に全角が続くものは、\$[A-Za-z_]\w*(?=[^\x00-\x7F]) という正規表現で拾えますが、grep では (?=...) の部分が書けないので、Python の re でまとめて走査しました。手元のスクリプトを一度に洗っておけば、set -u で止まるのを待たずに、共通の囲み忘れをまとめて修正できます。

set -u を入れておく効果

一つ目の囲み忘れは set -u を入れていたから見つかりました。このオプションは未定義の変数を参照すると当該の行で処理を止めてくれますが、入れていなければ未定義の変数は空文字列として扱われ、エラーも出ずにおかしな値で処理が進みます。止まると作業は中断しますが、未定義の変数を使った行で止まるのでどこを修正すればいいかはすぐ分かりました。日本語を出すスクリプトでは set -u を入れたうえで変数を波括弧で囲むようにしています。

状態変更のあとの数え直し

3 度の失敗のあと、副作用のある処理を流したら、そのあとで実際の状態を確認するようにしました。プロセスを落としたら ps を打ち直しますし、ファイルやコピーも同様で、消した数・残った数・コピー先のサイズを、面倒でも元と突き合わせます。処理が「済み」と出しても、実際に残っている数を数えてから終わりにします。この一手間を飛ばすと、空振りや取りこぼしに気づくのはたいてい手遅れになってからでした。結局、消す前と後で ps や wc -l をもう一度打つだけの話です。kill の件で ps を打ち直したときは、自分のセッションがまだ生きているかの確認も同じ回に入れました。自動化に組み込むときも、状態を変える処理の直後にこの確認を一行足しておきます。数が合わなければ処理を止めて、人に知らせます。

お客様の自動化や、データの移し替えを預かるときも、進め方は同じです。画面の表示や、緑のランプを、そのままは信じません。終了コードを見て、状態を変えたあとは実際の件数を数え、元と突き合わせます。シェルは、間違えてもたいていそのまま最後まで走るので、成功との見分けがつきません。そこで、自動化の各ステップの後ろには、件数を数え直す一行を足してあります。取り返しのつかない削除や空振りの見逃しを、ここで止めるためです。