部署在Vercel的应用仅单机能写入GCS，求助问题排查

• 验证Vercel环境变量配置
  本地运行时可能依赖本地GCS密钥文件（比如google-credentials.json），但Vercel Serverless函数无法直接读取本地文件。检查Vercel控制台的环境变量是否正确配置了GCS服务账号的密钥信息（需将JSON内容转义为字符串填入，或正确配置GOOGLE_APPLICATION_CREDENTIALS对应的变量）。代码中Storage实例的credentials参数需正确引用这些环境变量，避免仅本地生效。

• 确认GCS存储桶的实际权限
  所谓“公开状态”通常默认仅开放公开读取权限，写入操作仍需身份验证。检查桶的IAM政策：

  1. 是否为allUsers或allAuthenticatedUsers赋予了storage.objects.create权限；
  2. 服务账号是否拥有Storage Object Creator或更高权限。
     即使桶标记为公开，缺少写入权限会导致非本地请求失败。

• 检查CORS跨域配置
  其他设备的浏览器可能因CORS策略阻止上传请求：

  • 查看浏览器控制台是否有CORS相关报错；
  • 在Vercel的API路由中添加正确的CORS响应头（如Access-Control-Allow-Origin、Access-Control-Allow-Methods），确保允许前端域名的POST/OPTIONS请求。

• 排查formidable在Serverless环境的兼容问题
  Vercel Serverless函数的临时存储空间有限，formidable解析后的临时文件可能在上传至GCS前被清理。尝试：

  • 改用流式上传替代本地临时文件读取；
  • 检查parseForm后的file.path是否有效，是否存在文件找不到的错误（查看Vercel函数日志）。

• 校验请求参数与路径合法性

  • 确认其他设备的userId是否正确传递：若未登录导致userId为空，会生成无效路径products//${file.name}，可能触发GCS权限或路径错误；
  • 移除preconditionOpts: {ifGenerationMatch: 0}尝试上传：该选项要求目标文件不存在才允许上传，若其他设备上传的文件名已存在，会直接失败。

• 查看Vercel函数错误日志
  登录Vercel控制台，找到对应的API函数日志，查看上传请求失败时的具体错误信息（如GCS返回的403权限错误、文件解析错误等），这是定位问题最直接的依据。

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