使用Firebase Stripe订阅支付扩展时自定义声明失效问题排查

• 核对扩展配置：确认安装「Run Subscription Payments with Stripe」扩展时，已经开启Sync subscriptions to Firebase Auth custom claims配置项，未开启该开关时扩展不会自动同步订阅状态到Auth自定义声明。
• 校验Stripe Webhook配置：确认Stripe后台已配置扩展自动生成的Webhook端点，且已勾选所有customer.subscription.*类事件权限，Webhook事件推送失败会直接导致自定义声明不同步。
• 检查云函数服务账号权限：扩展使用的firebase-extensions@<你的项目ID>.iam.gserviceaccount.com服务账号，需要被授予Firebase Authentication Admin角色，缺少该权限时云函数无法修改用户自定义声明，会抛出权限类报错。
• 确认用户绑定关系正确：检查Firestore的customers集合下对应用户UID文档的stripeId字段，是否与Stripe后台对应客户ID完全匹配，绑定关系错误会导致声明同步到错误的Auth用户。
• 注意JWT刷新机制：自定义声明更新后，客户端现存的JWT不会自动更新，需要调用getIdToken(true)强制刷新ID令牌后才能读取到最新的声明内容，多数情况下的声明“失效”都是客户端未刷新令牌导致。

问题相关参考截图 #

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