You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

使用官方安装器后Next.js Fast Refresh无法正常工作

Next.js Fast Refresh 失效问题排查方案

针对你遇到的修改app/page.js后浏览器无更新、Fast Refresh不工作的问题,可按以下步骤排查解决:

  • 检查开发服务器状态
    确认npm run dev的终端无报错信息,比如ESLint语法错误、编译失败提示。若有报错,先修复对应问题再刷新页面。同时留意终端是否在文件保存后输出「event - compiled successfully」类的更新日志,若终端无反应,可能是编辑器未开启自动保存,或是文件权限存在问题。

  • 禁用浏览器缓存并强制刷新
    打开浏览器开发者工具(F12),在「网络」选项卡勾选「禁用缓存」,再刷新页面;或使用快捷键强制刷新:Ctrl+Shift+R(Chrome/Edge/Firefox通用)。

  • 确认文件修改路径正确
    对照你的文件夹结构截图,确保修改的是项目根目录下的app/page.js,而非其他不存在的目录(比如误操作了src文件夹,但你创建项目时未启用该目录)。

  • 重启开发服务器与浏览器
    关闭当前运行npm run dev的终端,重新执行npm run dev启动服务器;同时完全关闭浏览器所有标签页后重新打开,访问http://localhost:3000。

  • 排查杀毒软件或Windows Defender干扰
    部分杀毒软件或Windows Defender的实时保护可能会拦截Next.js的文件监听,导致无法检测到文件变化。可临时关闭实时保护测试,或把项目目录添加至信任列表。

  • 清理依赖与缓存重新构建
    执行以下PowerShell命令清理缓存与依赖,重新安装后启动服务器:

    rm -Recurse node_modules
    rm -Recurse .next
    npm install
    npm run dev
    
  • 检查Next.js配置(若有自定义)
    若项目中存在next.config.js,确认其中未设置fastRefresh: false(默认无此配置,若没有该文件可跳过此步骤)。

内容的提问来源于stack exchange,提问作者Aitor Martin

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.11 05:10:14