Next.js部署Vercel报错ENOENT: no such file or directory, stat

• 现有Next.js项目部署至Heroku时无任何报错，所有功能可正常运行
• 同一份代码部署至Vercel平台时，部署流程末尾抛出Error, ENOENT: no such file or directory, stat错误，错误定位指向项目内动态路由文件[...params].js
• 该动态路由文件承载三类核心逻辑：注册流程多步骤跳转、公开信息页渲染、后台用户信息编辑页渲染；文件内getServerSideProps方法实现会话校验、多接口数据拉取的服务端处理逻辑

Vercel和Heroku的部署架构存在本质差异：Heroku部署的是完整运行的Node.js服务，文件路径容错性高、运行基准路径固定为项目根目录；Vercel会将Next.js项目拆分为独立Serverless函数、静态资源分别打包，构建环境严格区分路径大小写，对文件引用的校验更严格，ENOENT错误本质是构建/运行时找不到指定路径的文件，优先从以下方向排查：

• 所有import引用的路径、文件名大小写/拼写匹配问题
• 动态路由文件本身的存放位置、命名规范问题
• 忽略列表配置是否误拦截了代码文件
• 组件内是否存在依赖固定相对路径的本地文件读取逻辑
• 构建缓存异常导致的文件映射错误

1. 优先全量校验import路径匹配度（最高发原因）
   逐行核对[...params].js以及其引用的所有组件内的import路径，和本地实际目录、文件名逐字匹配：
   • 核对目录名大小写：比如代码里写的common目录，实际目录是否命名为Common；register目录实际是否为Register
   • 核对文件名大小写、拼写：你贴出的代码中引入了StepFouth组件（拼写为Fouth，非正确拼写Fourth），优先核对对应组件的实际文件名是否和import语句完全一致，包括后缀名是否重复（比如实际文件是StepFouth.js.js这类隐藏后缀问题）
     这类大小写、拼写不匹配的问题，在Windows/macOS本地开发环境、Heroku部署环境下会被系统自动容错，不会触发报错，但Vercel构建环境基于Linux，严格区分大小写，只要有一个字符不匹配就会抛出找不到文件的ENOENT错误。
2. 校验动态路由文件的位置与命名
   确认[...params].js文件存放在pages目录的对应路由层级下，文件名使用半角括号，没有多余空格、特殊字符，符合Next.js动态路由命名规范。
3. 检查忽略列表配置
   打开项目根目录下的.gitignore、.vercelignore文件，确认没有将pages目录、common组件目录加入忽略规则，避免Vercel拉取代码时漏传对应文件。
4. 修正代码内的环境兼容问题
   • 增加路由参数加载兜底：Vercel构建预渲染阶段router.query在客户端hydration完成前是空对象，直接解构会拿到undefined，可增加加载态兜底：

     const ApplicantType = ({ data, describeData }) => {
       const router = useRouter();
       // 增加参数兜底
       const params = router.query.params || [];
       const [type] = params;
       const [index, setIndex] = useState(0);
       // 参数未加载完成时返回加载态
       if (router.isFallback || !type) return <div>加载中...</div>
       // 其余原有逻辑不变
     

   • 替换origin获取逻辑：next-absolute-url在Vercel Serverless环境下偶尔会拿到错误的服务地址，可直接使用Vercel自带的环境变量获取服务地址，替换getServerSideProps内的origin获取代码：

     let origin;
     if (process.env.VERCEL_URL) {
       origin = `https://${process.env.VERCEL_URL}`
     } else if (context.req.headers.host) {
       origin = `https://${context.req.headers.host}`
     } else {
       origin = "http://localhost:3000"
     }
     

5. 清空构建缓存重新部署
   如果以上配置都确认无误，可在Vercel项目的部署设置中，选择清空构建缓存重新部署；也可以自定义构建命令为rm -rf .next && next build，强制全量重新构建，避免旧缓存的错误文件映射引发异常。

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