在Vercel部署Astro项目时遭遇500:FUNCTION_INVOCATION_FAILED错误

错误核心定位 #

日志明确显示Error [ERR_MODULE_NOT_FOUND]: Cannot find module '/var/task/dist/entry.mjs'，说明Vercel的Serverless函数无法找到Astro构建生成的入口文件，这是导致500错误的直接原因。

排查与修复步骤 #

1. 本地验证构建产物 #

• 执行本地构建命令：npm run build（或pnpm/yarn build）
• 检查项目根目录下的dist文件夹，确认是否存在entry.mjs文件
  • 如果本地没有生成该文件，说明是Astro构建配置问题，而非Vercel部署问题

2. 检查Astro配置文件 #

打开astro.config.mjs，确认以下配置：

• 输出模式：如果项目使用SSR/API路由，需设置output: 'server'（静态站点无需此设置，但静态站点一般不会触发Serverless函数错误）
• 构建输出路径：确保没有自定义修改输出目录，默认应为dist

3. 核对Vercel构建配置 #

进入Vercel项目的Settings > Build & Development Settings，确认：

• Build Command：与本地一致，如npm run build
• Output Directory：设置为dist（必须和Astro构建输出目录匹配）
• Package Manager：如果本地用pnpm/yarn，需同步设置Vercel的包管理器，避免依赖安装差异

4. 清理缓存重新部署 #

• Vercel端：在部署页面点击Redeploy，选择「Clear build cache and redeploy」
• 本地端：删除node_modules、dist文件夹，执行npm install重新安装依赖后再构建

5. 验证Astro与Vercel适配器版本兼容性 #

• 检查package.json中@astrojs/vercel和astro的版本，确保两者版本匹配（例如Astro v4需搭配@astrojs/vercel v7+）
• 版本不兼容时，执行重装命令：

  npm uninstall @astrojs/vercel
  npm install @astrojs/vercel@latest
  

6. 统一Node.js版本 #

• 本地使用Node.js 18.x（与Vercel Runtime版本一致），可通过nvm切换：

  nvm use 18
  

• 重新构建并部署，避免因Node版本差异导致的构建产物路径错误

7. 排查ES模块混用问题 #

• 确保项目中所有导入/导出使用ES模块语法（import/export），避免混用CommonJS的require
• 若存在第三方CommonJS包，可在astro.config.mjs中添加esbuild配置处理：

  export default defineConfig({
    build: {
      esbuild: {
        format: 'esm',
        loader: { '.js': 'jsx' },
      },
    },
  });
  

验证修复 #

完成上述步骤后，本地构建确认dist/entry.mjs存在，再重新部署到Vercel，访问站点即可验证错误是否解决。

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