Vercel构建时Sentry产物未上传问题求助

问题描述 #

通过私有GitLab服务器使用Vercel CLI部署应用，部署脚本如下：

DEPLOYMENT_URL=$(VERCEL_ORG_ID=$VERCEL_ORG_ID VERCEL_PROJECT_ID=$VERCEL_PROJECT_ID vercel --yes --force \
    --token $VERCEL_TOKEN \
    --env NEXT_PUBLIC_SENTRY_DSN=$SENTRY_DNS \
    --build-env NEXT_PUBLIC_SENTRY_DSN=$SENTRY_DNS \
    --build-env SENTRY_AUTH_TOKEN=$SENTRY_AUTH_TOKEN \
    --build-env SENTRY_RELEASE=$CI_COMMIT_SHA \
    --env SENTRY_RELEASE=$CI_COMMIT_SHA \
    --regions fra1 )

vercel alias set $DEPLOYMENT_URL $APPLICATION_URL -t $VERCEL_TOKEN --scope ajouve

本地环境或已配置SENTRY_AUTH_TOKEN的GitLab CI流水线执行npm run build时，产物可正常上传至Sentry（上传数166），但通过Vercel构建时，Sentry上传数为0，无法完成产物上传。

排查与解决步骤 #

• 确认环境变量传递有效性
  在package.json的build脚本前添加调试命令，比如：

  "scripts": {
    "build": "echo \"SENTRY_AUTH_TOKEN: $SENTRY_AUTH_TOKEN\" && next build"
  }
  

  部署后查看Vercel构建日志，确认SENTRY_AUTH_TOKEN是否正确传入。同时检查该token是否拥有project:releases和org:read权限，权限不足会导致静默上传失败。

• 检查Sentry自动上传配置
  如果你使用@sentry/nextjs，确保next.config.js中开启自动上传：

  module.exports = {
    sentry: {
      autoUploadSourceMaps: true,
      autoInstrumentServerFunctions: true,
    },
  };
  

  也可以在build脚本中明确指定Sentry上传命令，例如：

  "scripts": {
    "build": "next build && sentry-cli releases files $SENTRY_RELEASE upload-sourcemaps .next/static --url-prefix '~/static'"
  }
  

• 验证Vercel环境变量优先级
  直接在Vercel项目的Settings > Environment Variables中手动添加SENTRY_AUTH_TOKEN、SENTRY_RELEASE、NEXT_PUBLIC_SENTRY_DSN这些变量，Vercel后台配置的变量优先级高于CLI传递的变量，测试是否能正常触发上传。

• 查看Vercel构建日志的报错信息
  进入Vercel部署详情页的Logs标签，搜索"Sentry"关键词，排查是否有token无效、网络连接失败、文件路径错误等静默报错，这些通常是上传失败的核心原因。

• 检查SDK版本兼容性
  确保@sentry/nextjs和sentry-cli使用最新稳定版，版本不兼容可能导致上传逻辑失效，执行npm update @sentry/nextjs sentry-cli更新后重新部署测试。

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