如何在物理设备上使用Firebase Storage模拟器生成的下载URL

核心问题是Storage模拟器默认生成的URL用了127.0.0.1（本地回环地址），物理设备访问的是自身的回环而非你的电脑，所以得改成电脑的局域网IP，具体方案如下：

1. 获取电脑的局域网IP #

• Windows：打开命令提示符，输入ipconfig，找到当前联网适配器（WiFi/以太网）的IPv4地址
• Mac/Linux：打开终端，输入ifconfig或ip addr，找到对应网卡（如en0/wlan0）的inet地址

2. 修改模拟器配置，让生成的URL自动用局域网IP #

有两种方式可选：

方式一：启动模拟器时指定参数 #

启动模拟器时，直接指定Storage的host为你的局域网IP，同时让模拟器监听所有网卡（0.0.0.0）：

firebase emulators:start --storage.host=你的局域网IP --storage.port=9199 --host=0.0.0.0

比如你的局域网IP是192.168.3.10，命令就是：

firebase emulators:start --storage.host=192.168.3.10 --storage.port=9199 --host=0.0.0.0

方式二：修改firebase.json配置文件 #

在项目根目录的firebase.json里添加Storage模拟器的host配置，以后启动就不用每次输参数：

{
  "emulators": {
    "storage": {
      "port": 9199,
      "host": "你的局域网IP"
    },
    "functions": {
      "port": 5001,
      "host": "0.0.0.0"
    },
    // 其他模拟器（如firestore、auth）的配置...
  }
}

修改后重新启动模拟器，Functions里调用getDownloadURL生成的URL就会自动用你的局域网IP，比如http://192.168.3.10:9199/xxx

3. 确保物理设备和电脑在同一局域网 #

手机和电脑必须连接同一个WiFi，或者通过USB共享网络（确保IP段互通），避免跨网段无法访问。

4. 临时修复已存在的URL #

如果数据库里已经存了旧的127.0.0.1开头的URL，可以在React Native客户端获取到URL后替换host：

// 仅开发环境使用，生产环境需移除
const fixEmulatorStorageUrl = (url) => {
  const computerLocalIp = "你的局域网IP";
  return url.replace('http://127.0.0.1:9199', `http://${computerLocalIp}:9199`);
};

// 使用示例
const savedUrl = await getUrlFromDatabase();
const usableUrl = fixEmulatorStorageUrl(savedUrl);

注意事项 #

• 检查电脑防火墙，确保放行9199（Storage端口）、5001（Functions端口）等模拟器用到的端口，避免被拦截
• 不要用0.0.0.0作为URL的host，它只是模拟器的监听地址，不是可被物理设备访问的有效IP

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