NextJS 13.4.4本地环境陷入编译循环，页面加载缓慢求助

开发者阿泽

2026-7-18

NextJS 13.4.4 本地编译循环、性能问题解决方案

很多开发者在升级到NextJS 13.4.4后都遇到过本地开发时的编译循环、页面加载缓慢（超10秒）的问题，以下是社区验证有效的解决思路：

禁用Fast Refresh：在next.config.js中添加配置关闭Fast Refresh，可终止编译循环：
```
module.exports = {
  fastRefresh: false,
}
```
排除不必要的监听文件：排查项目中是否有生成临时文件的工具（如CSS预处理器、代码生成脚本），这类文件的频繁变更会触发重复编译。可在next.config.js的webpack配置里忽略指定目录：
```
module.exports = {
  webpack: (config) => {
    config.watchOptions = {
      ignored: /node_modules|.next|temp/ // 根据实际情况调整忽略规则
    }
    return config
  }
}
```
切换版本：13.4.4的该问题在后续小版本（如13.4.5+）已被官方修复，降级到13.4.3或升级至最新稳定版可直接解决问题：
降级命令：npm install next@13.4.3
升级命令：npm install next@latest
清理缓存与依赖：删除.next文件夹和node_modules后重新安装依赖：
```
rm -rf .next node_modules
npm install
```
排查App Router代码：若使用App Router，检查是否存在组件渲染时意外修改文件系统、触发无限状态更新的情况——比如Server Component调用写入文件的函数，或Client Component的useEffect未正确设置依赖项导致重复触发。