Cloud Functions 1.0本地Shell使用服务账号凭据时遇签名错误

我之前也碰到过一模一样的问题，这个SigningError: Cannot sign data without client_email错误本质是本地运行环境缺少了给Cloud Storage文件生成签名URL所需的服务账号凭据——毕竟本地模拟器不像云端环境会自动注入这些认证信息。下面是一步步的解决方法：

1. 获取并配置Firebase服务账号凭据 #

• 打开你的Firebase控制台，进入「设置」→「服务账号」页面
• 点击「生成新的私钥」，下载对应的JSON格式凭据文件（保存到本地安全的位置，别提交到代码仓库）
• 设置环境变量指向这个凭据文件：
  • Mac/Linux终端：

    export GOOGLE_APPLICATION_CREDENTIALS="/绝对路径/到你的/service-account-file.json"
    

  • Windows命令提示符：

    set GOOGLE_APPLICATION_CREDENTIALS="C:\绝对路径\到你的\service-account-file.json"
    

  • Windows PowerShell：

    $env:GOOGLE_APPLICATION_CREDENTIALS="C:\绝对路径\到你的\service-account-file.json"
    

2. 确保正确启动Cloud Functions Shell #

• 先确认当前终端已经加载了上面的环境变量（可以重启终端或者重新执行环境变量设置命令）
• 进入你的Functions项目目录，用官方命令启动shell：

  firebase functions:shell
  

  不要直接用node命令运行单个函数文件，这样会跳过Firebase的配置加载流程。

3. 检查代码里的Admin SDK初始化 #

确保你的Admin SDK是自动读取环境变量凭据的，不要手动指定错误的配置：

const admin = require('firebase-admin');
// 不要手动传入错误的credential参数，让它自动读取GOOGLE_APPLICATION_CREDENTIALS
admin.initializeApp();

const gcs = admin.storage();
const bucket = gcs.bucket('你的存储桶名称');

// 你的上传和生成签名URL逻辑
bucket.upload(localFilePath, {destination: destinationPath})
  .then(() => {
    // 生成签名URL的代码
    return bucket.file(destinationPath).getSignedUrl({
      action: 'read',
      expires: '2030-01-01'
    });
  })
  .then(([url]) => {
    console.log('生成的URL:', url);
  })
  .catch(err => {
    console.error('错误:', err);
  });

4. 额外排查点 #

• 确认你当前使用的Firebase项目是正确的：执行firebase use 你的项目ID切换到对应项目
• 如果还是有问题，可以尝试删除functions/node_modules和package-lock.json，重新执行npm install，确保依赖版本和Cloud Functions 1.0兼容

内容的提问来源于stack exchange，提问作者John O'Reilly