NextJS+TypeScript部署Vercel时构建报错排查及解决

问题现象 #

部署基于TypeScript的Next.js项目到Vercel时，构建阶段出现类型不匹配错误，但本地执行pnpm run build及lint命令均无异常。检查代码确认涉及变量类型均为number，且已对idValue使用parseInt做类型转换，本地却未检测到任何报错。

尝试过的无效操作 #

• 清除Vercel缓存后重新部署
• 执行git rm -r --cached .清理Git缓存
• 将目标变量转为字符串进行测试
• 禁用GitHub Actions

关键排查线索 #

移除parseInt转换后，本地组件正常弹出类型提示，说明本地的TypeScript类型校验原本应该触发报错，但此前未正常工作。

最终解决方案 #

删除本地node_modules目录，重新执行pnpm install，此时本地成功检测到所有之前未暴露的类型报错，修复这些报错后重新部署Vercel，问题即可解决。

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