Flutter生产环境Firebase自定义令牌不匹配错误的无侵入解决方法

错误核心原因 #

这个错误本质是：Flutter客户端连接的Firebase项目，与生成自定义令牌的Cloud Function所属的Firebase项目不一致，或者客户端使用的Firebase Auth实例与初始化的应用不匹配。

分步解决方案 #

1. 确认Cloud Function使用生产环境的Firebase Admin SDK生成令牌

虽然GCP云函数会自动绑定部署所在项目的服务账号，但需确保生成令牌的代码没有硬编码开发环境配置：

• 检查云函数中Admin SDK的初始化代码，使用默认初始化即可（自动绑定生产环境项目）：

  const admin = require('firebase-admin');
  admin.initializeApp(); // 无参数，自动使用部署环境的默认配置
  

• 可以在云函数中添加日志，打印当前项目ID，验证是否为生产环境ID：

  console.log('当前Firebase项目ID:', admin.app().options.projectId);
  

  部署后查看云函数日志，确认项目ID与Flutter客户端的生产项目ID一致。

2. 修正Flutter客户端的Firebase Auth实例调用

你初始化了一个命名为"foo"的Firebase应用，但FirebaseAuth.instance默认会调用未命名的默认应用（该应用并未被初始化），导致Auth配置与你初始化的生产环境应用不匹配：

• 修改认证代码，明确使用已初始化的命名应用实例：

  // 获取已初始化的命名应用
  final firebaseApp = Firebase.app("foo");
  // 创建对应该应用的Auth实例
  final auth = FirebaseAuth.instanceFor(app: firebaseApp);
  // 使用该Auth实例完成登录
  await auth.signInWithCustomToken(firebase_token);
  

3. 验证Firebase客户端配置的项目ID一致性

检查firebase_options.dart中的生产环境配置，确保projectId字段与Cloud Function所在的生产项目ID完全一致：

• 打开firebase_options.dart，查看DefaultFirebaseOptions.android（对应测试平台）下的projectId，与云函数日志中打印的项目ID对比。
• 如果不一致，重新用FlutterFire CLI生成生产环境配置：

  flutterfire configure
  

  运行时选择生产环境的Firebase项目，覆盖现有firebase_options.dart，确保apiKey、appId、projectId等所有字段均为生产环境的值。

4. 验证自定义令牌的JWT字段（可选）

将Cloud Function生成的自定义令牌复制到JWT解析工具中，检查以下字段：

• iss：值应为https://securetoken.google.com/{生产项目ID}，确认项目ID正确。
• aud：值固定为https://identitytoolkit.googleapis.com/google.identity.identitytoolkit.v1.IdentityToolkit。
• 若iss中的项目ID与客户端不一致，说明云函数仍在使用开发环境的Admin SDK，需重新部署云函数到生产环境项目。

注意事项 #

• 所有操作基于现有生产应用，不要修改包名或删除应用，避免影响现有用户。
• 测试时使用生产环境的测试账号，隔离测试流程。

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