Next.js 13删除dashboard目录layout.tsx后模块找不到错误求助

问题场景 #

基于App Router搭建Next.js 13.4.5项目，在app/dashboard目录下创建过layout.tsx和page.tsx，原本运行正常；删除dashboard/layout.tsx后尝试仅使用根布局，却触发编译报错，提示找不到已删除的布局文件，且项目中无任何显式引用该文件的代码。

报错详情 #

./
Module not found: Can't resolve '/myproject/src/app/dashboard/layout.tsx'

问题根源 #

Next.js App Router会在.next/types目录自动生成路由相关的类型缓存文件，这些文件会记录路由结构的元数据。当删除layout.tsx后，旧的缓存文件仍保留了对该文件的引用，导致编译阶段仍会尝试查找它。

解决步骤 #

• 清理构建缓存：直接删除项目根目录下的.next文件夹，该目录存储了Next.js的编译缓存和自动生成的类型文件，清理后会重新生成匹配当前路由结构的元数据。
• 重启开发服务器：关闭正在运行的npm run dev或yarn dev进程，重新启动服务器，确保加载最新的文件结构，避免内存中残留旧的路由配置。
• （可选）兜底方案：如果前两步无效，可删除node_modules目录，重新执行npm install或yarn install，排除依赖缓存导致的异常。

额外提示 #

• 若后续需要为dashboard路由添加布局，直接创建layout.tsx即可，Next.js会自动识别并加载。
• 若想从根源避免这类问题，初始创建路由目录时就不要添加子布局，直接依赖根布局即可，无需创建无用的空布局文件。

用户提供的tsconfig配置 #

{
 "compilerOptions": {
  "target": "es5",
  "lib": ["dom", "dom.iterable", "esnext"],
  "allowJs": false,
  "skipLibCheck": true,
  "strict": true,
  "forceConsistentCasingInFileNames": true,
  "noEmit": true,
  "esModuleInterop": true,
  "module": "esnext",
  "moduleResolution": "node",
  "resolveJsonModule": true,
  "isolatedModules": true,
  "jsx": "preserve",
  "incremental": true,
  "plugins": [
  {
    "name": "next"
  }
],
"paths": {
  "@/*": ["./src/*"]
}
},
"include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
"exclude": ["node_modules"]
}

内容的提问来源于stack exchange，提问作者MrMz