如何在Vercel部署的Next.js应用中配置Google Cloud Storage私钥

核心问题排查与修复 #

• 环境变量设置错误：你之前在Vercel里给私钥加了额外的双引号，这会导致实际读取的私钥开头/结尾多了"，直接破坏密钥结构。正确操作是：

  1. 打开Vercel项目的「Settings → Environment Variables」
  2. 新建GCLOUD_PRIVATE_KEY变量，直接把原始私钥（从Google Cloud下载的JSON里的private_key字段内容，包括-----BEGIN PRIVATE KEY-----和-----END PRIVATE KEY-----以及中间的换行）粘贴到输入框，不要加任何引号，Vercel会自动处理多行内容。
  3. 同样确认GCLOUD_CLIENT_EMAIL变量没有多余引号，直接粘贴对应的值。

• 代码层面的换行处理：如果上述操作后仍有问题，替换之前的replace逻辑，改用以下方式确保换行符正确解析：

  credentials: {
    client_email: process.env.GCLOUD_CLIENT_EMAIL,
    private_key: process.env.GCLOUD_PRIVATE_KEY.replace(/\\n/g, '\n').trim()
  }
  

  加.trim()是为了避免环境变量前后可能存在的空白字符。

备选方案（解决特殊字符转义问题） #

如果Vercel的多行环境变量还是有转义问题，试试Base64编码方案：

1. 本地把原始私钥转成Base64字符串：
   在终端运行Node.js命令：

   node -e "console.log(Buffer.from('你的原始私钥内容').toString('base64'))"
   

2. 将生成的Base64字符串存储到Vercel的GCLOUD_PRIVATE_KEY环境变量中（同样不要加引号）。
3. 代码中解码使用：

   credentials: {
     client_email: process.env.GCLOUD_CLIENT_EMAIL,
     private_key: Buffer.from(process.env.GCLOUD_PRIVATE_KEY, 'base64').toString('utf8')
   }
   

额外检查项 #

• 确认Google Cloud服务账号权限：给该账号分配「Storage Object Creator」或「Storage Admin」角色，避免因权限不足被误判为密钥无效。
• 修改环境变量后，必须重新部署Vercel项目，确保新的环境变量被加载。

内容的提问来源于Stack Exchange，提问作者Cip