You need to enable JavaScript to run this app. 如何为Flutter应用添加SafetyNet attestation并配置AppCheck
优惠活动
大模型
产品
解决方案
定价
更多

如何为Flutter应用添加SafetyNet attestation并配置AppCheck

Flutter项目配置Firebase AppCheck(SafetyNet提供商)操作步骤

前置校验

先确认已完成的基础配置无问题:

  • Google Play控制台中你的应用已上传完整的SHA-256签名指纹,debug、release、测试环境的签名都需要同步上传
  • Firebase控制台AppCheck页面已为对应安卓应用启用SafetyNet提供商,实时数据库(Realtime Database)的强制校验开关测试阶段可以先关闭,避免拦截合法请求

第一步:添加依赖

在Flutter项目的pubspec.yaml中添加对应依赖:

dependencies:
  flutter:
    sdk: flutter
  firebase_core: ^最新稳定版
  firebase_app_check: ^最新稳定版
  firebase_database: ^最新稳定版

保存后执行flutter pub get拉取依赖。

第二步:安卓端配置

目前官方firebase_app_check包已内置支持SafetyNet,无需额外开发原生桥接代码,只需确认两项配置:

  • 打开android/app/build.gradle,确认应用ID和Firebase控制台填写的完全一致,签名配置正确
  • 打开android/build.gradle,确认谷歌服务插件版本不低于4.3.10

第三步:Flutter端初始化

在Firebase初始化完成后,立即初始化AppCheck并指定SafetyNet提供商:

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();
  // 按需做平台区分,SafetyNet仅安卓可用,iOS可搭配其他AppCheck提供商使用
  await FirebaseAppCheck.instance.activate(
    androidProvider: AndroidProvider.safetyNet,
    // 本地调试时可临时开启调试模式,正式发布必须删除该行
    // androidDebugProvider: AndroidProvider.debug,
  );
  runApp(const MyApp());
}

注意:本地测试阶段如果出现请求被拦截,可在Firebase控制台AppCheck页面生成调试令牌,临时使用调试模式配置,正式发布前必须移除调试相关配置,强制走SafetyNet校验。

第四步:验证配置生效

  1. 先保持实时数据库的AppCheck强制校验为关闭状态,运行应用发起一次读写请求
  2. 进入Firebase控制台AppCheck的请求指标页面,查看是否有标记为「已通过」的SafetyNet类型请求
  3. 确认所有合法请求都能正常通过校验后,再开启实时数据库的AppCheck强制校验即可

常见问题排查:如果出现请求被拦截,优先检查SHA-256签名指纹是否完整、应用ID是否完全匹配、SafetyNet是否在Firebase AppCheck中正确启用。

内容的提问来源于stack exchange,提问作者user2641103

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.09 04:39:00