python -I で動かすと「ZoneInfoNotFoundError: ‘No time zone found with key Asia/Tokyo’」。Windows の Python で -I を外したら通った

結論

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 がそちら側に入っていたために見えなくなった、と考えています(入っている場所までは確かめていません)。

解決手順

  1. -I を外して実行します。-I で避けたかった __pycache__ の書き出しは、環境変数で止めました。

bash
PYTHONDONTWRITEBYTECODE=1 python compare_source_coverage.py <世代フォルダ> <元の版.py> <直した版.py> compare.json

  1. これで 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 が読めているか」を疑うと早いです。

この記事を書いた人

realine

Windows の PC で、MT5(MQL5)の EA・インジケーターの開発、WordPress のプラグイン開発とサイト運営、PowerShell・Python での作業の自動化をしています。このサイトには、その作業で実際につまずいたことと、効いた直し方を、確かめた環境と手順つきで残しています。

運営者情報と記事の作り方