Node.js上传GCS文件后生成SignedUrl遇client_email错误求助

问题根源 #

该错误说明Node.js应用无法从GCP服务账号凭证中读取client_email字段，导致无法完成签名操作生成SignedUrl。以下是针对性修复步骤：

1. 修正Windows环境变量设置 #

你之前的命令添加了不必要的单引号，Windows命令行设置环境变量无需引号，正确命令：

set GOOGLE_APPLICATION_CREDENTIALS=test-project-sa.json

• 若凭证文件不在当前终端工作目录，必须填写绝对路径，示例：

  set GOOGLE_APPLICATION_CREDENTIALS=C:\Users\YourName\Documents\sample\test-project-sa.json
  

• 设置完成后必须重启终端，再运行Node应用，否则进程无法读取新的环境变量。

2. 简化Storage客户端初始化 #

若已通过环境变量指定凭证，无需手动传入projectId和keyFileName，客户端会自动加载：

// 替换原有Storage初始化代码
const storage = new Storage();

若要手动指定keyFileName，建议用绝对路径确保正确性：

const path = require('path');
const storage = new Storage({
  keyFileName: path.join(__dirname, 'test-project-sa.json')
});

3. 检查服务账号凭证与权限 #

• 打开test-project-sa.json文件，确认存在client_email字段，若缺失需重新下载服务账号的JSON凭证。
• 确保该服务账号拥有Storage Object Admin或Storage Signer角色（生成SignedUrl需要签名权限），可在GCP控制台IAM页面为服务账号添加对应角色。

4. 修正SignedUrl参数配置 #

你的需求是生成只读公网链接，但当前代码action设为"write"，需改为"read"；若已设置predefinedAcl: 'publicRead'，也可直接使用固定公网URL（无需SignedUrl），如需带过期时间的SignedUrl，调整参数如下：

const response = await fileRef.getSignedUrl({
  version: "v4",
  action: "read", // 改为只读权限
  expires: Date.now() + 24 * 60 * 60 * 1000, // 按需设置过期时间（示例为1天）
  contentType: "audio/mp4" // 根据音视频文件类型设置正确的contentType
});

固定公网URL拼接方式：

const publicUrl = `https://storage.googleapis.com/${process.env.GCS_BUCKET_NAME}/${storagepath}`;

额外优化点 #

• 移除冗余的bucket.acl.default.add调用，因上传时已设置predefinedAcl: 'publicRead'，重复设置无意义。
• 将fileRef.exists()改为await调用，避免异步时序问题：

const [exists] = await fileRef.exists();
if (exists) {
  console.log("File in database exists ");
}

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