如何在Flutter中请求Firebase AppCheck令牌？iOS FCM推送异常排查

可以主动请求AppCheck令牌 #

不管是iOS模拟器还是真机，都能通过Flutter的Firebase AppCheck插件主动获取并打印令牌，解决FCM推送因AppCheck验证失败被拒的问题。

Flutter端实现步骤 #

1. 配置依赖 #

在pubspec.yaml中添加Firebase核心与AppCheck依赖：

dependencies:
  firebase_core: ^2.15.0 # 替换为最新版本
  firebase_app_check: ^0.2.1+7 # 替换为最新版本

执行flutter pub get完成安装。

2. 初始化Firebase与AppCheck #

在应用启动入口（main.dart的main函数）完成初始化：

import 'package:firebase_core/firebase_core.dart';
import 'package:firebase_app_check/firebase_app_check.dart';
import 'package:flutter/material.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();
  
  // 激活AppCheck，iOS指定DeviceCheck provider
  await FirebaseAppCheck.instance.activate(
    androidProvider: AndroidProvider.playIntegrity,
    appleProvider: AppleProvider.deviceCheck,
  );
  
  runApp(const MyApp());
}

3. 主动获取并打印令牌 #

在需要的位置（比如页面初始化逻辑、按钮点击事件）调用getToken方法，将令牌输出到调试控制台：

void getAndPrintAppCheckToken() async {
  try {
    final appCheckToken = await FirebaseAppCheck.instance.getToken();
    print("AppCheck调试令牌: $appCheckToken");
    
    // 监听令牌刷新事件，实时获取更新后的令牌
    FirebaseAppCheck.instance.tokenChanges.listen((updatedToken) {
      print("刷新后的AppCheck令牌: $updatedToken");
    });
  } catch (error) {
    print("获取AppCheck令牌失败: $error");
  }
}

可以在页面的initState中调用，启动时自动获取：

@override
void initState() {
  super.initState();
  getAndPrintAppCheckToken();
}

iOS模拟器特殊配置 #

iOS模拟器不支持DeviceCheck，需要在Firebase控制台添加调试令牌：

1. 运行上述代码，查看调试控制台输出，会得到一个调试令牌（如果首次运行报错，日志中会包含需要添加的调试令牌字符串）。
2. 登录Firebase控制台 → 你的项目 → 应用检查 → 调试令牌 → 点击添加调试令牌，粘贴控制台中的令牌并保存。
3. 重启Flutter应用，再次获取令牌即可得到有效值，此时AppCheck会允许模拟器的请求，FCM推送可正常接收。

Node.js后端令牌验证（可选） #

如果你的Node.js后端需要验证AppCheck令牌有效性，使用Firebase Admin SDK实现：

const admin = require('firebase-admin');

// 初始化Admin SDK（确保已配置服务账号密钥）
admin.initializeApp();

async function validateAppCheckToken(token) {
  try {
    const validationResult = await admin.appCheck().verifyToken(token);
    console.log("AppCheck令牌验证通过", validationResult);
    return true;
  } catch (err) {
    console.error("AppCheck令牌验证失败", err);
    return false;
  }
}

排查要点 #

• 若仍无法获取令牌，检查iOS项目Info.plist是否添加调试令牌配置：

  <key>FirebaseAppCheckDebugToken</key>
  <string>你的调试令牌字符串</string>
  

• 确认Firebase控制台中iOS应用的Bundle ID与项目一致，且AppCheck功能已启用。

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