Next.js 13构建报错：Module not found，如何解决？

以下是几种针对性的修复方案，按优先级尝试：

• 检查导入路径大小写
  Next.js开发模式对文件路径大小写不敏感，但生产构建会严格匹配文件系统的实际文件名。比如导入import Header from './components/Header'但实际文件是header.js，dev模式能正常识别，build阶段就会触发模块找不到的错误。
  修复：统一所有导入语句的路径大小写，和本地文件系统的文件名完全一致。

• 重新安装完整依赖
  部分场景下next dev会缓存依赖，或局部依赖安装不完整时会 fallback 到全局依赖，但build阶段不会这么处理。执行以下命令重置依赖：

  rm -rf node_modules package-lock.json yarn.lock
  npm install # 对应使用yarn或pnpm则替换为yarn install/pnpm install
  

• 排查Next.js配置的webpack规则
  如果自定义了next.config.js中的webpack配置，可能误将项目核心文件目录（如src/、components/）加入了exclude规则，导致build时无法解析模块。
  修复：检查next.config.js的webpack配置段，确保没有错误排除必要的文件路径。

• 修正动态导入的写法
  使用动态导入时如果用变量拼接路径（如dynamic(() => import(./components/${name}))），dev模式下能正常运行，但build阶段webpack无法静态解析这类路径，会触发模块找不到的错误。
  修复：避免动态拼接导入路径，改用明确的路径，或使用Next.js支持的动态导入语法（比如限定可选路径范围）。

• 清理全量缓存后重新构建
  除了.next文件夹，还可以清理包管理器的缓存，彻底重置构建环境：

  npm cache clean --force
  rm -rf .next
  next build
  

• 检查Git忽略规则（生产部署场景）
  如果项目用Git管理，若.gitignore误排除了项目自有模块文件，本地dev模式能正常访问，但生产环境部署时这些文件未被提交，导致build报错。
  修复：检查.gitignore确保没有误删必要的项目文件；如果是第三方依赖，确认已添加到package.json的dependencies中。

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