Expo SDK 53 iOS端使用Firebase Auth时出现“component auth has not been registered yet”错误求助

安全阿岳

2026-4-8

大家好，最近把Expo Go升级到SDK 53之后，iOS端用Firebase Auth的时候突然碰上个头疼的错误：component auth has not been registered yet。我当前的Firebase初始化代码写在firebase.client.js里，代码如下：

import { initializeAuth, getReactNativePersistence } from 'firebase/auth';
import AsyncStorage from '@react-native-async-storage/async-storage';
import firebaseConfig from './firebaseConfig';
import { getApps, initializeApp, getApp } from 'firebase/app';

const app = getApps().length === 0 ? initializeApp(firebaseConfig) : getApp();
const auth = initializeAuth(app, { 
  persistence: getReactNativePersistence(AsyncStorage), 
});

export { app, auth };

折腾了好一阵，试了几个方法终于解决了，给大家分享下可能的原因和修复方式：

检查Firebase依赖版本一致性：SDK 53对应的Expo环境对Firebase包版本有一定要求，我之前的firebase/auth和firebase/app版本不一样，升级到同一个最新稳定版之后，错误就消失了。建议打开package.json确认所有firebase相关包的版本号完全相同。
确认AsyncStorage的配置正确性：Expo SDK 53里如果用@react-native-async-storage/async-storage，要确保已经通过npx expo install @react-native-async-storage/async-storage正确安装，并且没和其他存储类库冲突。如果还是有问题，也可以试试换成Expo官方的expo-secure-store来做Auth持久化，配置方式类似。
调整Auth的初始化时机：我之前是在文件加载时直接初始化Auth，可能Firebase App还没完全初始化好就触发了Auth初始化。后来把初始化逻辑移到App组件的useEffect里，或者封装成自定义Hook在组件挂载时调用，确保App实例就绪后再初始化Auth，就避免了这个注册错误。
清理缓存并重启环境：iOS的Expo Go很容易积缓存，我试着先卸载Expo Go重装，然后删除项目的node_modules和锁文件（yarn.lock或package-lock.json），重新执行npm install或yarn install，最后用expo start -c清除缓存启动项目，这一步解决了不少依赖加载的奇怪问题。

如果上面的方法都没效果，还可以试试把initializeAuth替换成getAuth并手动设置持久化，代码示例如下：

import { getAuth, setPersistence } from "firebase/auth";
import { getReactNativePersistence } from 'firebase/auth/react-native';
import AsyncStorage from '@react-native-async-storage/async-storage';
import { getApps, initializeApp, getApp } from 'firebase/app';
import firebaseConfig from './firebaseConfig';

const app = getApps().length === 0 ? initializeApp(firebaseConfig) : getApp();
const auth = getAuth(app);

// 手动设置持久化
setPersistence(auth, getReactNativePersistence(AsyncStorage))
  .then(() => {
    // 这里可以放置后续的Auth操作逻辑
  })
  .catch((error) => {
    console.error('设置持久化失败：', error);
  });

export { app, auth };

内容来源于stack exchange