React Native集成Firebase在Expo iOS端运行登录功能报错

问题表现 #

• 基于Firebase Auth实现的邮箱密码登录功能，在Android端、Web端均可正常运行
• 通过Expo Go在iOS设备调试时，触发登录逻辑直接抛出错误
• 原有登录逻辑代码：

const handleLogin = () => {
signInWithEmailAndPassword(auth, email, password)
.then((userCredential) => {
const user = userCredential.user;
console.log('logged in')
  }).catch((error) => {
    alert(error)
  });
}

根因说明 #

这个问题是Expo Go iOS环境的特有兼容问题，和登录逻辑本身无关：

1. 用getAuth()默认初始化Auth实例时，iOS端Expo Go会加载不兼容的Web端持久化模块，导致底层鉴权请求失败
2. iOS系统自带ATS（应用传输安全）规则默认拦截未声明的第三方域名请求，Firebase的鉴权接口域名如果没加白名单会直接被阻断
   Android和Web环境没有上述两个限制，所以功能可以正常运行。

修复步骤 #

1. 替换Auth实例初始化方式
   改掉原有默认初始化的写法，显式指定React Native兼容的本地持久化方案：

   import { initializeApp } from 'firebase/app';
   // 不要引入getAuth，换成initializeAuth + reactNativeLocalPersistence
   import { initializeAuth, reactNativeLocalPersistence } from 'firebase/auth';
   
   const firebaseConfig = [你的Firebase项目配置];
   const app = initializeApp(firebaseConfig);
   // 显式传入持久化配置，适配Expo Go iOS环境
   const auth = initializeAuth(app, {
     persistence: [reactNativeLocalPersistence]
   });
   export { auth };
   

   如果之前已经用initializeAuth初始化过，先检查有没有重复调用初始化方法，重复初始化也会触发iOS端报错。

2. 配置iOS端ATS白名单
   打开项目根目录的app.json，在expo.ios节点下添加Firebase相关域名的ATS例外配置，避免系统拦截鉴权请求：

   {
     "expo": {
       "ios": {
         "infoPlist": {
           "NSAppTransportSecurity": {
             "NSExceptionDomains": {
               "googleapis.com": {
                 "NSIncludesSubdomains": true,
                 "NSExceptionRequiresForwardSecrecy": true
               },
               "firebaseapp.com": {
                 "NSIncludesSubdomains": true,
                 "NSExceptionRequiresForwardSecrecy": true
               }
             }
           }
         }
       }
     }
   }
   

3. 清缓存重启验证
   • 完全关闭iOS设备上的Expo Go，杀掉后台进程
   • 在项目目录执行npx expo start -c清除Metro打包缓存
   • 重新扫码连接iOS设备测试登录功能

额外排查项 #

• 确认安装的Firebase JS SDK版本和当前使用的Expo SDK大版本匹配，版本不兼容会导致原生层通信异常
• 如果登录前有自动校验登录态的逻辑，加一层auth实例初始化完成的判断，不要在初始化完成前调用任何Auth相关方法
• 如果catch拿到的错误码是auth/network-request-failed，直接按上述两个配置项检查即可，不需要改登录业务逻辑

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