Firebase Admin SDK：getUser与listUsers返回customClaims值不一致问题

出现这种差异主要是以下两个核心原因：

1. 批量查询的缓存机制差异 #

firebase.auth().getUser()是实时拉取单个用户的最新数据，不会依赖缓存；而listUsers()作为批量用户查询接口，默认会启用缓存来优化性能，缓存有效期内会返回旧数据。如果你刚通过setUserCustomClaims更新了用户权限，缓存里的用户数据还没同步更新，就会出现customClaims.userType为空的情况。

2. 分页查询的游标缓存问题 #

如果使用listUsers()的分页功能（传递pageToken参数），之前分页返回的游标对应的用户数据可能已被缓存，即使后续更新了用户的customClaims，基于旧游标查询的结果依然会是缓存的旧数据。

对应的解决办法： #

• 禁用缓存查询：以Node.js Admin SDK为例，调用listUsers()时添加缓存禁用参数：

  admin.auth().listUsers(1000, { cache: false })
    .then((listUsersResult) => {
      // 处理最新的用户数据
    });
  

• 等待数据同步：Firebase Auth的用户数据同步到批量查询数据源需要几秒到几分钟的时间，非紧急场景可等待后再调用listUsers()。
• 重新发起无游标查询：若使用了分页，放弃之前的pageToken，从头开始查询，避免使用缓存的分页数据。

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