Expo+React Native Firebase模拟器报错：需传入非空字符串URL

解决步骤 #

1. 确保URL包含完整协议前缀 #

firebase.auth().useEmulator()要求传入带HTTP/HTTPS协议的完整URL，仅写192.168.1.26:9099这类格式会被判定为无效值，触发错误。必须写成：

firebase.auth().useEmulator('http://192.168.1.26:9099');

2. 排查环境变量加载逻辑 #

如果用环境变量存储模拟器地址，变量名必须以EXPO_PUBLIC_开头（Expo规定公开环境变量需加此前缀，否则安卓端无法读取）：

• 在.env文件中定义：

  EXPO_PUBLIC_AUTH_EMULATOR_URL=http://192.168.1.26:9099
  

• 代码中读取：

  const emulatorUrl = process.env.EXPO_PUBLIC_AUTH_EMULATOR_URL;
  if (emulatorUrl) {
    firebase.auth().useEmulator(emulatorUrl);
  }
  

  避免使用未加前缀的变量，否则安卓运行时会返回undefined，导致传入空字符串。

3. 硬编码URL验证问题根源 #

先暂时硬编码正确URL，排除动态赋值或环境变量的问题：

// 仅在开发环境启用模拟器
if (__DEV__) {
  firebase.auth().useEmulator('http://192.168.1.26:9099');
}

如果硬编码后错误消失，说明问题出在URL的动态赋值逻辑，而非网络访问。

4. 确认网络连通性 #

• 保证电脑和安卓手机在同一局域网（如连接同一个WiFi），USB连接时可开启电脑网络共享，让手机通过USB访问电脑网络。
• 关闭电脑防火墙，或添加9099端口的允许规则，避免端口被拦截。
• 用手机浏览器访问http://192.168.1.26:9099，若能看到Firebase Auth模拟器页面，说明网络连通正常。

5. 关于类型定义的说明 #

无需修改.d.ts文件，此错误为运行时传入空值导致，并非类型定义问题。编译时类型检查通过，说明代码语法符合要求，问题出在运行时URL实际值为空。

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