使用Vercel CLI部署NextJS预构建项目时遇Lambda路由查找错误

常见排查与修复步骤 #

• 检查构建产物完整性
  执行vercel build后，确认项目根目录下的.vercel/output目录结构完整，需包含functions、static子目录和config.json文件。若目录缺失或文件不全，重新执行vercel build，全程留意是否有报错信息。
• 对齐Vercel CLI与Next.js版本
  运行vercel --version和npm list next查看版本号，确保两者版本兼容。如果版本差异过大，升级Vercel CLI到最新稳定版，或调整Next.js版本至对应兼容范围。
• 校验路由配置
  检查App Router（app/目录）或Pages Router（pages/目录）下的路由文件，确保动态路由命名合规，API路由正确导出GET/POST等处理函数。若next.config.js中有rewrites/redirects配置，排查是否存在路由规则冲突。
• 清理缓存后重新构建部署
  删除.vercel、.next目录及node_modules/.cache文件夹，依次执行npm install、vercel build、vercel deploy --prebuilt，避免缓存残留导致的产物异常。
• 确认部署命令执行上下文
  执行vercel deploy --prebuilt时，务必在项目根目录运行；如果是monorepo项目，需添加--cwd参数指定子项目的具体路径。

额外验证方法 #

如果上述步骤无效，尝试直接运行vercel deploy（不带--prebuilt参数）测试部署。若直接部署正常，说明预构建产物生成过程存在问题，重点查看vercel build的日志输出，排查隐藏的警告或错误。

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