Next.jsでChunkLoadErrorがキャッシュクリアしても直らない原因【本番だけ壊れた時の対処法】

Failed to load chunk server/chunks/ssr/[root-of-the-server]__13i22a4._.js

server/chunks/ssr というパスが気になりました。これはSSR（サーバーサイドレンダリング）用のチャンクファイルです。

.open-nextのアセットを確認する

OpenNextjsのビルド結果は .open-next フォルダに生成されます。その中のアセットディレクトリを確認してみました。

Get-ChildItem .open-next\assets\_next\static\chunks\ssr -Recurse | Measure-Object

結果は Count: 0 でした。SSRチャンクが0件です。

次に .next フォルダ側を確認しました。

Get-ChildItem .next\server\chunks\ssr -Recurse | Measure-Object

こちらは Count: 90 でした。ビルドは正常に完了しているのに、OpenNextjsがSSRチャンクをアセットフォルダにコピーしていなかったのです。

Cloudflareキャッシュではなくビルドの問題

ここで原因がCDNやブラウザではなく、Windowsビルド環境とOpenNextjsの相性問題であることが確定しました。OpenNextjsの公式ドキュメントにも「WindowsとはOpenNextは完全に互換性がない」という旨の警告が存在します。

WARN OpenNext is not fully compatible with Windows.
WARN For optimal performance, it is recommended to use Windows Subsystem for Linux (WSL).

デプロイのたびにこの警告は出ていましたが、動いているように見えたので無視していました。これが原因でした。

実際に効いた解決方法

原因が特定できたので、解決方法はシンプルでした。WSL（Windows Subsystem for Linux）でビルドとデプロイを行うことです。ホッとしました。

WSLを起動してクリーンビルドする

# PowerShellからWSLを起動
wsl

# プロジェクトフォルダに移動
cd /mnt/c/Users/[ユーザー名]/[プロジェクトフォルダ]

# ビルドキャッシュを完全に削除
rm -rf .open-next .next

# 依存関係をLinux用に再インストール
rm -rf node_modules
npm install

# デプロイ実行
npm run deploy

node_modules の削除と再インストールが重要です。WindowsとLinuxではネイティブモジュールのバイナリが異なります。Windows用のバイナリのままWSLで動かそうとすると、別のエラーが発生します。

SSRチャンクが正しく生成されているか確認する

デプロイ前に以下で確認できます。

ls .open-next/assets/_next/static/chunks/ssr | wc -l

0件であればビルドが正常に完了していません。WSLでの npm install と npm run deploy をやり直してください。

判断基準

• ChunkLoadErrorが本番のみで発生している → ビルド環境を疑う
• .open-next/assets/_next/static/chunks/ssr が0件 → WindowsビルドのOpenNextjs問題
• WSLで再ビルド後も0件 → node_modules を削除して npm install からやり直す
• ローカルでも同じエラーが出る → 別の原因（コードのエラー等）

再発防止のためにやったこと

解決した後、同じ問題が二度と起きないように手順を固定しました。

デプロイはWSLで行うルールを固定する

ローカル確認（npm run dev）はWindowsのPowerShellで行っても問題ありません。しかしビルドとデプロイに関しては必ずWSLで行うというルールを自分の中に作りました。

具体的には以下のコマンドを定型化しています。

# デプロイ手順（WSLで実行）
wsl
cd /mnt/c/Users/[ユーザー名]/[プロジェクトフォルダ]
npm run deploy

WSLが使えるか事前に確認する

# バージョン確認（WSL2が入っていればOK）
wsl --version

WSLが入っていない場合は Microsoft Store からインストールできます。Windows 10以降であれば追加費用なしで使えます。

作業環境のメモを残す

「デプロイはWSLで」という一行をプロジェクトのREADMEやメモに残しておくことをおすすめします。数ヶ月後に別のPCで作業するときや、他の人が引き継ぐときに同じ問題で詰まらないようにするためです。

まとめ

ChunkLoadErrorがキャッシュクリアで直らない場合の原因と対処法をまとめます。

原因： WindowsでOpenNextjsをビルドするとSSRチャンクが .open-next/assets に正しくコピーされない。

解決： WSLでビルド環境ごと切り替えて node_modules から再インストールし直す。

再発防止： ビルドとデプロイはWSLで行う運用ルールを固定する。

表面のエラーメッセージだけを見ていると「キャッシュの問題」に見えますが、実際はビルド環境とデプロイツールの相性という構造的な問題でした。同じエラーで詰まっている方の参考になれば幸いです。

こうした「表面のエラーではなく構造の問題」は、単発の対処ではなく設計から見直す必要があります。bizinets.bizでは、こうした再現性のある仕組みづくりの判断軸を体系化して公開しています。[判断軸について読む](https://bizinets.biz/judgment-axis/)

WindowsでのデプロイとOpenNextjsの非互換については、[CloudflareデプロイがWindowsだけ失敗して本番が白画面になる原因とWSLで解決した手順](https://bizinets.life/cloudflare-deploy-fail-windows)でSSRチャンクが0件になる仕組みから詳しく解説しています。ChunkLoadErrorの根本原因を構造で理解したい方はあわせて読んでみてください。

環境を整えた後は、GSCのデータをAPIで自動取得してSEO改善のサイクルを回すことが次のステップになります。[Search Console APIでCSV出力する方法【初心者でもコピペで動いた最小コード】](https://bizinets.life/search-console-api-csv-export)では、コマンド1つで検索データを取得できる仕組みの作り方を解説しています。