
firebase sdk 10.0.0 存在认证状态持久化 bug,导致 react native 应用重启后 `currentuser` 丢失;升级至 v10.1.0 或更高版本即可修复该问题,并确保本地持久化(默认 `local` 模式)正常生效。
在使用 Expo + React Native + Firebase 构建认证驱动型应用时,开发者常期望用户登录后即使关闭并重新打开 App,其认证状态(即 auth.currentUser)仍能自动恢复——这依赖 Firebase 的本地持久化机制(Persistence)。Firebase Web SDK 默认启用 local 持久化(等效于 indexedDB 在浏览器、AsyncStorage 在 React Native 环境),理论上应无缝支持跨会话保持用户状态。
然而,Firebase JS SDK v10.0.0 中存在一个已知缺陷:onAuthStateChanged 监听器在应用冷启动(如首次加载或进程被系统回收后重启)时,可能无法及时从本地存储中还原用户对象,导致 user 初始为 null,且后续未触发状态更新回调。该问题已在 v10.1.0 版本中正式修复(见 Firebase Release Notes)。
✅ 正确做法是立即升级 Firebase 依赖:
npm install firebase@^10.1.0 # 或使用 yarn yarn add firebase@^10.1.0
同时建议同步检查 firebase/app 和 firebase/auth 是否均为一致版本(v10.1.0+),避免混合版本引发兼容性问题:
// package.json 片段
"dependencies": {
"firebase": "^10.1.0",
"expo": "~51.0.0"
}⚠️ 注意事项:
- 无需手动配置持久化:v10.1.0+ 已默认启用 local 持久化,setPersistence(auth, browserLocalPersistence) 等显式调用在 React Native 中不适用(且可能报错),应完全移除。
- 确保 onAuthStateChanged 在组件挂载前注册:你的 AuthContextProvider 实现方式正确,但请确认 firebase_app 初始化无误(尤其 initializeApp 调用时机早于任何 Auth 操作)。
- Expo 兼容性:使用 Expo 开发时,请确保 expo-dev-client 或 EAS Build 配置已适配新版 Firebase(通常无额外操作,但建议清理缓存:npx expo start -c)。
升级后,useAuthContext() 获取的 user 将在 App 启动时自动从本地持久化存储中恢复,loading 状态也会准确反映初始化过程,不再出现“登录后重启变 guest”的现象。这是 Firebase 官方推荐的轻量级、零配置持久化方案,无需引入 @react-native-async-storage/async-storage 或自定义序列化逻辑。










