迁移至Next.js App Router后构建输出仍显示Pages Router相关内容

排查与修复步骤 #

• 清除构建缓存：Next.js的缓存可能保留了旧的Pages Router资源，执行命令清理：

  rm -rf .next
  rm -rf node_modules/.cache
  

  清理后重新执行构建。

• 检查Next.js配置：打开next.config.js，确认没有遗留Pages Router相关配置，比如pageExtensions若曾自定义过，需恢复为默认值（或仅保留App Router兼容的扩展名）。

• 升级Next.js版本：确保使用v13.4及以上的稳定版，旧版本可能存在App Router兼容问题，执行升级：

  npm install next@latest
  

• 检查项目目录：确认根目录下无隐藏的pages文件夹（如.pages），同时排查第三方依赖是否意外引入Pages Router相关文件。

• 核对构建脚本：查看package.json中的build命令，移除任何强制启用Pages Router的参数（如--experimental-app-dir false）。

验证修复效果 #

重新运行构建命令：

npm run build

检查输出是否已不再显示Route (pages)相关条目。

内容的提问来源于stack exchange，提问作者Zé Pedro Mota