← 戻る

wrangler.jsonがあるとCloudflare Pagesダッシュボードのビルド環境変数が無視される

cloudflare-pages wrangler env-vars

問題

Cloudflare Pagesプロジェクトに wrangler.json（または .jsonc）が存在すると、ビルド時にダッシュボードで設定した環境変数が読み込まれない。

ビルドログに以下が出る：

Checking for configuration in a Wrangler configuration file (BETA)
Found wrangler.json file. Reading build configuration...
Build environment variables: (none found)

原因

wrangler.json ベースの設定（BETA）が有効になると、ダッシュボードのビルド設定を完全に上書きする。wrangler.json に環境変数の定義がなければ「none found」になる。

ダッシュボードの「変数とシークレット」セクションで設定した値はランタイム用バインディングとして扱われ、ビルドプロセスには渡されない。

対処法

  • wrangler.json を削除/リネームしてダッシュボード設定に戻す（シークレットをgitに入れずに済む）
  • pages_build_output_dir 等はダッシュボードの「ビルド出力」で設定可能
  • ローカルの astro dev や wrangler pages dev（引数指定）には影響なし