Firebase custom claims设置成功但客户端无法读取问题求助

核心原因 #

你遇到的问题本质是Firebase客户端ID Token的缓存机制导致的：
Firebase客户端默认会将用户的ID Token缓存1小时，你在云函数中更新用户custom claims后，客户端本地仍然持有更新前生成的旧Token，旧Token的payload里自然没有新增的admin声明。

解决方案 #

1. 强制刷新ID Token #

调用getIdTokenResult()时传入参数true，要求客户端跳过缓存直接向Firebase Auth服务请求最新的Token，就能拿到更新后的声明：

getRecords() {
  firebaseInstance.auth.currentUser.getIdTokenResult(true) // 传入true强制刷新
  .then(idTokenResult => {
    console.log("ADMIN:", idTokenResult.claims.admin) // 此时可正常拿到admin字段
  })
  .catch(err => console.error(err))
}

2. 其他需要注意的场景 #

• 如果调用addAdminRole后立刻执行获取声明的逻辑，建议在云函数返回成功后再触发刷新操作，避免云函数还没完成声明写入就提前获取Token
• 如果是多端登录场景，其他设备上的同个账号需要等到Token自动过期（1小时）、或者下次主动刷新Token时才能拿到新的声明，也可以引导用户重新登录立刻生效

验证方法 #

如果强制刷新后仍然拿不到声明，可以将获取到的ID Token复制到JWT解码工具中查看payload字段，确认admin声明是否已经写入Token，进一步定位是服务端写入问题还是客户端读取问题。你已经通过云函数getUserRecord拿到了{admin: true}的结果，说明声明已经成功写入用户账号，几乎可以确定是本地Token缓存的问题。

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