結論
Windows の Python では時刻帯のデータを tzdata パッケージから読んでいて、python -I(分離モード)で動かしたときにそれが読めず ZoneInfoNotFoundError になっていました。-I を外して実行したら通りました。
-I は、余計な環境変数や場所を読まない「安全な起動」のつもりで普段から付けていました。ところが、ZoneInfo("Asia/Tokyo") を import 時に作るモジュールを読ませたところで、いきなり落ちました。
症状
Git Bash から、別のスクリプトを読み込む比較用のスクリプトを -I 付きで動かしました。
python -I compare_source_coverage.py <世代フォルダ> <元の版.py> <直した版.py> compare.json
読み込まれた側のモジュールの、時刻帯を作る行で止まりました。
File "...\build_c_periodic_actual_virtual_incremental_v1.py", line 56, in <module>
DAILY_TIMEZONE = ZoneInfo("Asia/Tokyo")
File "C:\Program Files\WindowsApps\PythonSoftwareFoundation.Python.3.13_3.13.3824.0_x64__qbz5n2kfra8p0\Lib\zoneinfo\_common.py", line 29, in load_tzdata
raise ZoneInfoNotFoundError(f"No time zone found with key {key}")
zoneinfo._common.ZoneInfoNotFoundError: 'No time zone found with key Asia/Tokyo'
同じモジュールは、定例の実行(-I を付けない起動)では普通に動いていました。
環境
| 項目 | 内容 |
|---|---|
| OS | Windows 11 |
| Python | 3.13(Microsoft Store 版。パスが C:\Program Files\WindowsApps\PythonSoftwareFoundation.Python.3.13_...) |
| シェル | Git Bash |
| 落ちた起動 | python -I スクリプト.py |
| 通った起動 | PYTHONDONTWRITEBYTECODE=1 python スクリプト.py |
原因
エラーの出どころが zoneinfo\_common.py の load_tzdata になっているのが手がかりです。zoneinfo は、OS の時刻帯データが見つからないとき、tzdata パッケージからデータを読みにいきます。Windows には zoneinfo が使える形の時刻帯データが無いので、この tzdata 頼みになります。
その tzdata が、-I を付けたときだけ読めませんでした。-I は環境変数(PYTHON...)を無視し、利用者用の site-packages も探す場所から外します。tzdata がそちら側に入っていたために見えなくなった、と考えています(入っている場所までは確かめていません)。
解決手順
-Iを外して実行します。-Iで避けたかった__pycache__の書き出しは、環境変数で止めました。
bash
PYTHONDONTWRITEBYTECODE=1 python compare_source_coverage.py <世代フォルダ> <元の版.py> <直した版.py> compare.json
- これで import が通り、比較結果の JSON が最後まで出ました。
tzdata がどこに入っているかを見たいときは、-I の有無で次を比べると切り分けやすいはずです(今回は試していません)。
python -c "import tzdata; print(tzdata.__file__)"
python -I -c "import tzdata; print(tzdata.__file__)"
再発防止・気づき
-Iは「何も足さない起動」なので、pip install --userなどで入れた部品も見えなくなることがあります。zoneinfoのように、Windows では外の部品に頼る標準ライブラリもあります。- 本番の実行が
-Iなしで動いているなら、検証用の起動も同じ条件にそろえる方が、落ちる場所の違いで迷いません。 ZoneInfoNotFoundErrorの行にload_tzdataが出ていたら、時刻帯の名前の打ち間違いより先に「tzdataが読めているか」を疑うと早いです。