Firebase Auth令牌未过期却触发TOKEN_EXPIRED错误求助

1. 确保Auth实例初始化时绑定租户ID #

问题核心可能是刷新页面后Auth实例重建时，租户ID设置时机过晚。SDK在authState监听启动前就会尝试用无租户的实例验证本地缓存的令牌，导致令牌与租户上下文不匹配，被错误判定为TOKEN_EXPIRED。

正确做法是在初始化Auth实例时直接指定租户ID，而非登录后或监听回调内设置：

import { initializeApp } from 'firebase/app';
import { getAuth, Auth } from 'firebase/auth';

const firebaseConfig = { /* 你的项目配置 */ };
const app = initializeApp(firebaseConfig);
const auth: Auth = getAuth(app);
// 初始化阶段就绑定租户ID，确保页面刷新后Auth实例从一开始就关联租户
auth.tenantId = 'your-tenant-id';

2. 验证登录请求的租户绑定 #

确认登录时的授权请求是在租户上下文内发起的，否则生成的令牌不会关联租户，后续用租户实例验证时会触发无效错误：

import { GoogleAuthProvider, signInWithPopup } from 'firebase/auth';

const provider = new GoogleAuthProvider();
// 给Google Provider附加租户ID参数，确保登录生成的令牌绑定租户
provider.setCustomParameters({
  tenantId: 'your-tenant-id'
});

// 发起带租户的登录请求
signInWithPopup(auth, provider)
  .then(result => { /* 处理登录结果 */ })
  .catch(error => { /* 处理错误 */ });

解码登录后的令牌，检查firebase.tenant字段是否存在且与你的租户ID一致，同时确认aud字段匹配项目ID。

3. 调整Angular/Fire的authState监听时机 #

Angular/Fire的authState是冷Observable，firstValueFrom可能在Auth实例完成租户初始化前就获取了用户状态，导致SDK用未关联租户的实例校验令牌。

改用Firebase原生initializeAuth显式配置租户与持久化，再监听authState：

import { initializeAuth, browserLocalPersistence } from 'firebase/auth';
import { authState } from '@angular/fire/auth';

// 显式初始化Auth，注入租户ID
const auth = initializeAuth(app, {
  persistence: browserLocalPersistence,
  tenantId: 'your-tenant-id'
});

// 确保实例初始化完成后监听用户状态
authState(auth).subscribe(user => {
  if (user) {
    // 处理已登录用户逻辑
  }
});

4. 强制刷新令牌验证缓存问题 #

刷新页面时，SDK可能读取了未绑定租户的旧令牌缓存。尝试强制刷新令牌，验证是否能解决问题：

if (user) {
  // 强制刷新令牌，获取关联租户的有效令牌
  const idTokenResult = await user.getIdTokenResult(true);
  // 用新令牌执行后续逻辑
}

如果强制刷新后错误消失，说明本地缓存的旧令牌（无租户）是问题根源，可清理浏览器缓存或确保登录流程始终生成绑定租户的令牌。

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