環境変数の確認と設定

「設定したはず」は、だいたい入っていない

本番だけアプリが落ちる。特定の実行環境でだけテストが通らない。原因を探すと、ほとんどが環境変数の入れ忘れか、名前の打ち間違いです。

ここで大事なのは、想像ではなくいま実際に何が入っているかを見ることです。値をひとつ確かめるコマンドが printenv です。

何も表示されずに終わったら、その名前の環境変数は存在しません。空文字が入っているのか、そもそも無いのかは区別しにくいので、まずは「出るか出ないか」で判定してください。

名前をうろ覚えなら、一覧から絞り込みます。

printenv を引数なしで打つと、いま渡されている環境変数が全部並びます。数が多いので grep と組み合わせるのが実用的です。

その 1 回だけ、値を差し替えて試す

本番と同じ設定で動かしたい、でも今の画面の設定は壊したくない、という場面があります。コマンドの前に 名前=値 を書くと、その実行のあいだだけその値が渡ります。

2 回目の出力が元に戻っているところが要点です。この書き方なら、設定を戻し忘れて次の作業を汚す心配がありません。

切り分けにも使えます。設定が原因かどうかを疑ったら、その 1 回だけ値を変えて動かし、結果が変わるかを見ます。変わるなら設定の話、変わらないならコードの話だと分かり、探す範囲が一気に狭まります。

続けて使いたい値は export で置き、要らなくなったら unset で消します。

無いなら、動き出す前に止める

いちばん困るのは、環境変数が空のまま処理が半分だけ進むことです。接続先が空文字のまま動いて、意味の分からないエラーを後から出します。

そこで、値が無いときの振る舞いを書いておきます。省略していいものには既定値を与え、無いと困るものはその場で止めます。

:- が既定値、:? が必須チェックです。起動用のコマンドの先頭にこの 2 つを並べておくと、設定漏れがその場で分かり、原因を追う時間がまるごと消えます。

もうひとつ、値に空白が入るときはダブルクオートで囲んでください。囲まないと空白の位置で切り離され、別々の引数として渡ってしまいます。

1. export を使って MESSAGE を定義する
2. bash -c でサブシェルを起動し、その中で echo $MESSAGE を実行する