如何为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校验。
第四步:验证配置生效
- 先保持实时数据库的AppCheck强制校验为关闭状态,运行应用发起一次读写请求
- 进入Firebase控制台AppCheck的请求指标页面,查看是否有标记为「已通过」的SafetyNet类型请求
- 确认所有合法请求都能正常通过校验后,再开启实时数据库的AppCheck强制校验即可
常见问题排查:如果出现请求被拦截,优先检查SHA-256签名指纹是否完整、应用ID是否完全匹配、SafetyNet是否在Firebase AppCheck中正确启用。
内容的提问来源于stack exchange,提问作者user2641103
相关产品推荐
相关产品推荐

