開発中に突然ページの読み込みが停止し、コンソールでリクエストしました。 .vite/deps/chunk-xxx.js 戻る 504 Outdated Optimize Dep私はこの状況に何度か遭遇しました。通常、これはコードの間違いではなく、Vite の事前構築された依存関係キャッシュの問題です。
01 |問題の症状と根本原因
現象は非常に単純です。ページの読み込みが停止し、ブラウザーがリクエストを要求します。 .vite/deps/chunk-xxx.js いつ戻る 504 Outdated Optimize Dep。
一般的な理由は、Vite の事前構築された依存関係のキャッシュが破損するか期限切れになり、キャッシュ内のチャンクが現在の依存関係のバージョンと不一致になることです。特定のトリガー条件は、使用される Vite バージョンの公式ドキュメントと実際のログに依存します。一般的なトリガー シナリオは 3 つあります。git ブランチの切り替え、パッケージの依存関係の追加または削除、およびサービスの異常終了です。
フローチャート TD A[页面卡住加载] –> B[请求 .vite/deps/chunk-xxx.js]
B –> C{リターン 504
古い最適化 Dep} C –>|是| D[预构建依赖缓存损坏或过期]
D –> E[缓存 chunk 与当前依赖版本不匹配]
E –> F1[切换 git 分支]
E –> F2[增删 package 依赖]
E –> F3[服务非正常退出]
02 |迅速な処理プロセス
高速な軽量ソリューションを優先します。
- フロントエンド開発サービスを停止します
- プロジェクトのルート ディレクトリ (つまり、フロントエンドの上位ディレクトリ) のパスが正しいことを確認した後、キャッシュ ディレクトリを削除します。
rm -rf frontend/node_modules/.vite - フロントエンドサービスを再起動します
- ブラウザの強制更新
Ctrl+Shift+R
ここでは特別な注意を払う必要があります。削除のみを行ってください。 .vite 目次、node_modules全体を削除しないでください時間を大幅に節約できます。
フローチャート TD S[出现 504 Outdated Optimize Dep] –> A[停止前端 dev 服务]
A –> B[删除 frontend/node_modules/.vite]
B –> C[重启前端服务]
C –> D[浏览器强制刷新 Ctrl+Shift+R]
D –> E{問題は解決しましたか} E –>|はい| F[完成]
E –>|いいえ| G[进入兜底方案]
03 |隠蔽計画
上記の手順が無効な場合は、フロントエンド ディレクトリに入って実行します。 npm install(このコマンドは、package.json と lockfile に基づいて依存関係を再構築し、node_modules を更新する場合があります。lockfile の変更が期待どおりであることを確認してください)、次に繰り返します: サービスの停止 → 削除 .vite キャッシュ → 再起動し、コンソールがまだ 504 を返すかどうかを確認します。
フローチャート TD A[快速处理流程无效] –> B[进入 frontend 目录]
B –> C[执行 npm install]
C –> D[停止前端 dev 服务]
D –> E[删除 .vite 缓存]
E –> F[重启前端服务]
F –> G{コンソールはまだ 504 を返しますか} G –>|いいえ| H[完成]
G –>|そうです|私[结合官方文档与实际日志进一步排查]
この一連の操作はフロントエンドのコンパイル キャッシュのみをクリーンアップすることに注意してください。バックエンドコードやビジネスデータベースデータには影響しません。
04 |予防のヒント
ブランチを切り替えて変更する package.json 後でリソース読み込みの例外が発生した場合は、Vite の事前構築済みキャッシュのクリアを優先できます。これは通常、node_modules を完全に再インストールするよりも高速です。ただし、依存関係自体が正しくインストールされていないか、ロックファイルに一貫性がない場合は、最初に依存関係のインストールを実行する必要があります。
一文に凝縮したバージョン: Vite 新聞 504 Outdated Optimize Depまずnode_modulesの下にあるものを削除してください .vite キャッシュし、フロントエンドを再起動し、ブラウザを強制的に更新します。無効な場合は、再試行してください npm installビジネスデータには触れません。
私に従ってAIと一緒に成長してください~
