Firebase模拟器中无法使用服务账户获取存储文件下载URL的问题

核心问题分析 #

你遇到的Cannot sign data without client_email、文件找不到、socket hang up错误，本质都是服务账户配置错误导致的——生成Storage签名URL需要服务账户的私钥来签名请求，而模拟器不会自动提供生产环境的签名能力，必须手动配置。

正确配置步骤 #

1. 获取并安全存储服务账户文件 #

• 登录Firebase控制台，进入项目的「设置 > 服务账户」页面，点击「生成新的私钥」，下载JSON格式的服务账户文件。
• 将文件放到项目的functions目录下，立即把functions/serviceAccount.json添加到.gitignore，绝对不要提交到版本控制系统。

2. 正确设置环境变量启动模拟器 #

在项目根目录执行以下命令（Mac/Linux环境）：

# 设置服务账户文件路径（相对于项目根目录）
export GOOGLE_APPLICATION_CREDENTIALS="./functions/serviceAccount.json"
# 启动模拟器，替换为你的项目ID
firebase emulators:start --project=你的项目ID

3. 简化Admin SDK初始化 #

删除手动传入的服务账户参数，使用默认初始化即可——模拟器会自动读取环境变量中的服务账户信息：

import admin from 'firebase-admin';

// 不需要额外配置，自动读取环境变量
admin.initializeApp();

4. 排查文件找不到的错误 #

如果还是提示ENOENT：

• 用ls functions/serviceAccount.json在项目根目录执行，确认文件存在。
• 执行chmod 644 functions/serviceAccount.json，确保文件有可读权限。

更安全的服务账户使用方式 #

直接存储JSON文件有泄露风险，推荐用Firebase CLI环境变量管理：

1. 将服务账户文件转成base64编码：

   base64 functions/serviceAccount.json > serviceAccount.base64
   

2. 将编码内容设置为Cloud Functions环境变量：

   firebase functions:config:set service.account="$(cat serviceAccount.base64)"
   

3. 在函数中解码并初始化Admin SDK：

   import admin from 'firebase-admin';
   import { config } from 'firebase-functions';
   
   // 从环境变量解码服务账户信息
   const serviceAccount = JSON.parse(Buffer.from(config().service.account, 'base64').toString());
   admin.initializeApp({
     credential: admin.credential.cert(serviceAccount)
   });
   

这种方式不需要本地存储JSON文件，避免了泄露风险。

开发测试替代方案：跳过签名URL #

在模拟器环境中，你可以直接拼接Storage文件的公共访问URL，无需生成签名URL，适合开发测试：

// 拼接模拟器Storage文件的访问URL
const downloadURL = `http://localhost:9199/v0/b/${object.bucket}/o/${encodeURIComponent(object.name)}?alt=media`;

// 存入Firestore
const images = firestore.collection("images");
return images.add({
  imageURL: imageLink,
  downloadURL: downloadURL,
});

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