React Native中Firebase httpsCallable模拟器抛未处理Promise rejection

按问题影响优先级从高到低逐一核对：

• 核心网络连通性问题（也是模拟器无任何运行日志的根因）
  React Native 运行在设备/模拟器环境时，代码中配置的localhost指向的是运行JS代码的设备自身，而非本地启动Firebase模拟器的电脑。设备本身的5001端口没有运行服务，请求根本没有抵达模拟器，自然不会产生任何运行日志，客户端直接抛出internal网络类错误。
  修正方式：

  • 如果使用iOS模拟器测试：确认useEmulator的地址配置正确，关闭可能拦截本地回环请求的VPN、代理工具。iOS模拟器与宿主机共享网络栈，本身可以正常访问宿主机的localhost服务。
  • 如果使用安卓模拟器、实体Expo Go设备测试：将localhost替换为电脑在局域网下的实际IP地址（例如192.168.1.100），确保测试设备与电脑处于同一WiFi网络，关闭电脑防火墙对5001端口的拦截。
    验证方法：直接在测试设备的浏览器中访问http://<对应地址>:5001，如果能看到Firebase Functions模拟器的响应内容，说明网络链路通畅，否则优先解决网络问题。
    额外注意：测试调用时请将传入的uid: "mock"替换为Firebase Auth项目中真实存在的用户UID，避免因为无效UID触发查询错误影响排查。

• 云函数HttpsError的参数传值错误
  你补充的异常捕获逻辑中，new https.HttpsError("not-found", error)的写法不符合SDK规范。HttpsError构造函数要求第二个参数为人类可读的字符串类型错误消息，直接传入原生error对象会触发序列化失败，导致云函数执行抛出500错误，同样会触发客户端的internal报错。
  修正后的云函数代码示例：

  export const findUserByUid = functions.https.onCall(async (data, context) => {
      try {
          const foundUser = await admin.auth().getUser(data.uid);
          return { user: foundUser.email };
      } catch (error) {
          // 直接复用Auth抛出的错误状态码，避免硬编码不匹配的错误类型
          return new https.HttpsError(
              error.code || "internal",
              error.message,
              error.errorInfo
          );
      }
  });
  

  注意：admin.auth().getUser()查询不到用户时抛出的error本身就是标准的not-found类型错误，不需要手动硬编码错误状态码。

• 错误栈的误导说明
  你看到的异常栈中出现@firebase/firestore的代码路径，并不是你代码中误调用了Firestore。这是Firebase JS SDK内部的通用错误映射公共代码，被functions、firestore等多个模块共享打包到了同一个构建文件中，和你编写的Firestore业务逻辑没有关联。

• 调试辅助配置
  启动模拟器时可以去掉--only functions参数，启动全量模拟器套件，打开默认地址http://localhost:4000的模拟器UI，可直观查看所有入站请求、函数执行日志、网络错误，大幅降低排查成本。

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