Firebase模拟器环境下如何生成Storage预签名URL？

问题原因 #

Firebase Storage模拟器并未实现预签名URL的生成功能——预签名URL依赖Cloud Storage生产服务的签名机制，模拟器没有内置该组件。即使Admin SDK连接到模拟器，getSignedUrl()方法仍会调用生产环境的签名接口，导致生成的URL指向生产桶，而本地模拟器的文件并不存在于生产环境中，因此访问失效。

解决方案：环境判断+模拟器直接访问URL #

在代码中判断当前是否处于Storage模拟器环境，若是则直接构造模拟器的公开访问URL（模拟器内的存储无需预签名即可访问，适合本地测试），生产环境则继续使用预签名URL。

修改后的代码： #

const expireDate = Date.now() + 1000 * 60 * 15; // 15 minutes

const storageRef = admin.storage().bucket().file(path);

// 检测是否运行在Storage模拟器环境
if (process.env.FIREBASE_STORAGE_EMULATOR_HOST) {
  // 构造模拟器的直接访问URL
  const encodedPath = encodeURIComponent(path);
  return `http://${process.env.FIREBASE_STORAGE_EMULATOR_HOST}/v0/b/${storageRef.bucket.name}/o/${encodedPath}?alt=media`;
} else {
  // 生产环境生成预签名URL
  const url = await storageRef.getSignedUrl({
    action: "read",
    expires: expireDate,
  });
  return url[0];
}

说明： #

• FIREBASE_STORAGE_EMULATOR_HOST是模拟器自动设置的环境变量，格式为localhost:9199（默认端口），用于标识当前连接的是Storage模拟器。
• 模拟器的Storage支持直接HTTP访问，?alt=media参数表示返回文件内容，无需预签名即可获取本地存储的文件。
• 若需要模拟权限验证逻辑，可以在返回模拟器URL前，保留原有的用户权限检查代码，确保测试流程和生产环境一致。

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