Firebase Admin SDK连接Storage模拟器时HTTPS报错求助

Firebase Admin SDK 默认会对 Storage 模拟器的连接使用 HTTPS，但本地运行的 Storage 模拟器本身只支持 HTTP，这是导致 SSL 版本错误的核心原因。另外还要注意 Docker 容器的网络特殊性，以下是具体解决步骤：

• 验证环境变量是否生效：进入 Docker 容器内部，执行 echo $STORAGE_EMULATOR_HOST，确认变量值正确传递。如果没读到，检查容器启动命令中环境变量的传递方式是否正确（比如用 -e STORAGE_EMULATOR_HOST=xxx 参数）。
• 强制 SDK 使用 HTTP 连接：仅设置环境变量可能不足以让 SDK 切换到 HTTP，需要在初始化 Storage 时显式指定 API 端点为 HTTP：

  const admin = require('firebase-admin');
  admin.initializeApp();
  
  const storage = admin.storage();
  storage.bucket().setOptions({
    apiEndpoint: `http://${process.env.STORAGE_EMULATOR_HOST}`
  });
  

• 修正 Docker 网络地址：如果 Storage 模拟器运行在宿主机上，容器内的 localhost 或 127.0.0.1 指向容器自身，无法访问宿主机服务。此时需要替换为宿主机的 Docker 专属地址：
  • Windows/macOS：使用 host.docker.internal:9199
  • Linux：使用宿主机的网桥 IP（通常是 172.17.0.1），或者启动容器时添加 --network host 参数让容器共享宿主机网络
• 确认模拟器配置：Storage 模拟器默认以 HTTP 运行，无需额外开启 HTTPS，所以无需修改模拟器的启动参数。

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