tsconfig路径配置正确仍出现Cannot find module错误求助

1. 检查继承的tsconfig.base.json配置 #

你的tsconfig.json继承了../../tsconfig.base.json，上层配置可能会覆盖当前的baseUrl或paths规则：

• 打开tsconfig.base.json，确认它的compilerOptions里没有设置冲突的baseUrl（比如设为了上层目录）
• 检查base配置中的paths映射，确保不会和当前项目的路径规则冲突

2. 简化并验证路径映射 #

冗余的路径映射可能导致解析混乱，先简化配置并验证：

• 保留最通用的映射，删除多余项：

  "paths": {
    "@/*": ["./src/*"]
  }
  

  因为@/constants/*已经被@/*覆盖，无需单独配置
• 确认baseUrl为.（项目根目录），和paths里的./src/*路径匹配

3. 清理Next.js缓存 #

缓存残留可能引发路径解析异常，执行以下命令清理：

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

之后重新执行npx next build

4. 检查文件名大小写一致性 #

如果开发环境是Windows（不区分大小写），但构建环境是Linux/macOS（区分大小写），文件名大小写不匹配会触发错误：

• 确认src/constants下的文件确实是next-auth.ts，而非Next-Auth.ts等变体
• 确保导入语句里的路径大小写和实际文件名完全一致

5. 确认include范围覆盖目标文件 #

检查tsconfig.json的include数组，显式添加目标文件路径避免模糊匹配遗漏：

"include": [
  "next-env.d.ts",
  "**/*.ts",
  "**/*.tsx",
  "src/constants/**/*.ts"
]

6. 验证Next.js版本兼容性 #

如果你使用Next.js 13+ App Router：

• 确认compilerOptions.plugins里的next插件配置正确，这是App Router路径解析的必要项
• 尝试升级到最新稳定版的Next.js和TypeScript，修复版本兼容问题

7. 确认构建命令的执行目录 #

必须在包含tsconfig.json的项目根目录执行npx next build，如果在子目录执行，路径映射会基于当前目录失效

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