如何检测Firebase Storage模拟器是否处于正常运行状态？

connectStorageEmulator 方法仅会为Storage实例配置本地模拟器的端点地址，不会主动校验服务是否正常运行，因此需要手动发送测试请求验证可用性，具体实现如下：

实现代码 #

1. 基础初始化逻辑 #

和你现有的连接逻辑保持一致即可：

const firebaseApp = initializeApp(appConfig.firebase)
const storage = getStorage(firebaseApp)
connectStorageEmulator(storage, 'localhost', 9199)

2. 模拟器状态检测函数 #

import { ref, getMetadata } from "firebase/storage";

async function isStorageEmulatorRunning(storage) {
  // 指向一个大概率不存在的测试文件路径
  const testFileRef = ref(storage, 'internal/emulator_health_check')
  try {
    await getMetadata(testFileRef)
    // 请求成功说明模拟器正常运行
    return true
  } catch (err) {
    // 匹配网络连接失败类错误，说明模拟器未启动
    const isConnectError = err.message.includes('Failed to fetch') 
      || err.message.includes('CONNECTION_REFUSED') 
      || err.code === 'storage/retry-limit-exceeded'
    if (isConnectError) {
      return false
    }
    // 其余错误（如404文件不存在、权限不足）说明模拟器已正常响应请求，属于运行状态
    return true
  }
}

3. 分支逻辑调用示例 #

const emulatorIsConnectedAndRunning = await isStorageEmulatorRunning(storage)
if (emulatorIsConnectedAndRunning) {
  // 模拟器正常运行时的逻辑
} else {
  // 模拟器未运行时的逻辑
}

注意事项 #

• 检测函数为异步方法，需要使用await或者.then处理返回结果
• 如果Storage安全规则禁止匿名读取，可给测试路径单独开放读权限，或者改用「上传临时空文件+删除」的无副作用逻辑做检测
• 可对检测结果做本地缓存，避免每次判断都发送重复请求

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