CloudflareデプロイがWindowsだけ失敗して本番が白画面になる原因とWSLで解決した手順

結論｜WindowsでCloudflareデプロイが失敗する正体

Windowsで npm run deploy を実行したとき、Cloudflareへのデプロイが失敗することがありますよね。再ビルドしても再デプロイしても直らない。その原因は、OpenNextjs（Next.jsをCloudflare Workersで動かすツール）がWindowsと完全に非互換であることです。

この記事は以下に当てはまる方向けです。

• Windows環境でNext.js + Cloudflare Workersを運用している
• npm run deploy でデプロイしたが本番サイトが壊れる・白画面になる
• Cloudflareデプロイ後に突然白画面になった
• ローカル（npm run dev）では正常に動作している
• 再ビルドや再デプロイを繰り返しても状況が変わらない

問題の根本は「ビルドツールのOS依存性」です。OpenNextjsはLinux環境を前提に設計されており、Windowsでビルドするとファイルのコピー処理が正常に完了しません。キャッシュやデプロイの手順ではなく、ビルド環境そのものを変えることが唯一の解決策です。

なお、この問題はChunkLoadErrorが本番だけ発生するケースと密接に関係しています。白画面と同時にChunkLoadErrorが出ている場合は、同じ根本原因である可能性が高いです。

WindowsとLinuxでバイナリが違う

Next.jsがビルドで使う lightningcss や sharp などのライブラリは、OSごとに異なるネイティブバイナリを使います。Windows用にインストールされた node_modules をそのままWSL（Linux）で動かそうとすると、バイナリが合わずにビルドが失敗します。逆にWSL上でインストールした node_modules をWindowsで動かしても同様です。

OpenNextjsが出す警告の意味

デプロイのたびに以下の警告が出ていませんでしたか？

WARN OpenNext is not fully compatible with Windows.
WARN For optimal performance, it is recommended to use Windows Subsystem for Linux (WSL).
WARN While OpenNext may function on Windows, it could encounter unpredictable failures during runtime.

「動くかもしれないが予測不能な障害が起きる可能性がある」という内容です。私はこの警告を長らく無視していましたが、実際に本番で壊れてから意味を理解しました。

最初に試したが効果がなかった対処

詰まっているときは思いつく対処を片っ端から試してしまいますよね。私もそうでした。試したがまったく効かなかった対処を正直に書きます。同じことを繰り返して時間を無駄にしないためにも、最初に把握しておくことをおすすめします。

ブラウザキャッシュの削除・ハードリロード

Ctrl+Shift+R でのハードリロードと、Chromeの設定から「閲覧履歴データの削除」を実施しました。白画面は変わらず。原因がブラウザ側にないので当然の結果でした。

Cloudflareキャッシュのパージ

Cloudflareのダッシュボードから「すべてをパージ」を実行しました。こちらも改善なし。CDN側のキャッシュが原因ではなく、アップロードされたファイルセット自体に問題があるためです。

.nextフォルダ削除と再ビルド

Remove-Item -Recurse -Force .next
npm run build

ビルド自体は正常に完了します。しかし再デプロイ後も本番サイトは白画面のままでした。

.open-nextフォルダ削除と再デプロイ

Remove-Item -Recurse -Force .open-next .next
npm run deploy

同様に完了はしますが、本番では改善されませんでした。

wranglerを直接実行

wrangler deploy

これは別の意味で失敗しました。以下のエラーが出ます。

'wrangler' は、コマンドレット、関数、スクリプト ファイル、または操作可能なプログラムの名前として認識されません。

wranglerはグローバルインストールされていないため、PowerShellから直接呼べません。npx wrangler deploy とすれば実行できますが、根本の問題（Windowsビルド）は変わりません。

依存関係の競合を解消

npm install 時に以下のようなエラーが出ることがあります。

npm error Could not resolve dependency:
npm error peer next@">=15.5.15 <16 || >=16.2.3" from @opennextjs/cloudflare@1.19.2

next を 16.1.6 から 16.2.4 に上げることで解消できます。ただしこれはインストールエラーの解消であり、ビルドのWindows問題とは別です。解消しても本番サイトが壊れる問題は続きます。

発生した環境とエラーの詳細

私が実際にどのような状況で詰まったでしょうか。再現性のために環境と症状を正確に書きます。

構成

• Next.js 16.2.4（Turbopack）
• @opennextjs/cloudflare 1.19.2
• wrangler 4.84.0
• ホスティング：Cloudflare Workers
• ビルド・デプロイ環境：Windows 11 PowerShell

実際のエラーログ

CloudflareのWorkerログに以下が流れてきました。

{
  "level": "error",
  "message": "⨯ ChunkLoadError: Failed to load chunk server/chunks/ssr/[root-of-the-server]__13i22a4._.js from runtime for chunk server/app/page.js"
}

トップページ（/）だけが白画面になり、記事ページ（/[slug]）は正常に表示されていました。SSRチャンクが特定のページだけ読み込めない状態でした。

ローカルは正常・本番のみ壊れる

npm run dev でのローカル確認は完全に正常でした。npm run deploy でデプロイした直後から本番が壊れるというパターンです。デプロイ自体は成功しているように見える（エラーなく完了する）ため、原因の特定に時間がかかりました。

原因を特定するためにやった切り分け

デプロイコマンドは成功しているのに本番が壊れる。この状況に正直お手上げ感がありました。改めてエラーログを分析して、原因を一つずつ絞り込んでいきました。

SSRチャンクの生成状況を確認する

Cloudflare Workersでのデプロイには、.open-next というフォルダにビルド結果が格納されます。その中のSSR用チャンクを確認してみました。

# .open-next側（Cloudflareにアップロードされるもの）
Get-ChildItem .open-next\assets\_next\static\chunks\ssr -Recurse | Measure-Object

結果：Count: 0