Capacitor iOS端Firebase Auth插件未同步登录状态至JS库

核心问题原因 #

Capacitor Firebase Authentication插件的原生认证状态不会自动同步到Firebase JS Auth库，两者的会话管理相互独立，因此即使原生端登录成功，JS库仍会处于未认证状态。

解决方案步骤 #

1. 手动同步原生认证状态到JS库 #

监听Capacitor插件的authStateChange事件，当状态变更时，获取当前用户的ID Token，并用Firebase JS Auth的方法手动完成登录，实现状态同步。

示例代码：

import { FirebaseAuthentication } from '@capacitor-firebase/authentication';
import { getAuth, signInWithCustomToken } from 'firebase/auth';

// 监听Capacitor端认证状态变化
FirebaseAuthentication.addListener('authStateChange', async (user) => {
  if (user.user) {
    // 获取当前用户的ID Token
    const { token } = await FirebaseAuthentication.getIdToken();
    const auth = getAuth();
    // 通过自定义Token登录JS库，同步认证状态
    await signInWithCustomToken(auth, token);
  } else {
    // 登出时同步JS库状态
    const auth = getAuth();
    await auth.signOut();
  }
});

2. 确认Auth实例初始化逻辑 #

你的初始化代码已区分原生与Web平台，需确保initializeAuth在iOS端的配置正常生效，尤其是持久化设置。可补充初始化后的状态检查：

import { initializeAuth, indexedDBLocalPersistence, getAuth } from 'firebase/auth';
import { Capacitor } from '@capacitor/core';
import { FirebaseApp } from './your-firebase-app-config';

export const Authentication = Capacitor.isNativePlatform() 
  ? initializeAuth(FirebaseApp, {
      persistence: indexedDBLocalPersistence,
      // 可选：若使用OAuth登录，需配置popupRedirectResolver
    }) 
  : getAuth(FirebaseApp);

// 初始化后监听JS库的用户状态
Authentication.onAuthStateChanged((user) => {
  console.log('JS Auth用户状态:', user);
});

3. 验证基础配置与权限 #

• 确认Firebase控制台中iOS应用的包名、SHA-1指纹配置正确
• 检查ID Token的受众（audience）与你的Firebase项目匹配
• 调用Firestore/数据库时，确保使用的是同步后的Auth实例

额外排查方向 #

• 查看iOS端Xcode控制台的Auth相关日志，定位潜在错误
• 确认Capacitor Firebase Authentication插件版本与Firebase JS SDK版本兼容
• App冷启动时，主动获取一次原生用户状态并同步到JS库，避免状态丢失

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