如何在Flutter应用中为Firebase Cloud Messaging(FCM)添加测试设备
Flutter集成FCM后指定测试设备推送的实现方案
第一步:在目标测试设备上获取有效FCM注册令牌
在测试设备对应的Flutter应用初始化逻辑里,添加代码获取当前设备的专属FCM令牌:
// 测试设备运行时打印输出当前设备的FCM令牌 final deviceToken = await FirebaseMessaging.instance.getToken(); debugPrint("当前测试设备的FCM令牌: $deviceToken");
拿到这串唯一的字符串令牌后复制保存,不要把这个测试令牌混到正式用户的推送接收列表里。
两种不触达生产用户的定向测试方式
- 方式1:Firebase控制台定向单设备测试(零代码改动,最快上手)
进入Firebase控制台的云消息发送界面,选择「在设备上测试」的发送模式,把刚才复制的测试设备令牌粘贴到测试设备输入框里再发送通知。这种方式下发的通知只会推送到你指定的设备,完全不会进入生产环境的推送分发链路,不会给任何正式用户发通知,物理真机、能正常获取令牌的模拟器都支持。 - 方式2:独立测试主题实现长期批量测试
如果你需要长期在多台测试设备上反复测试推送效果,不需要每次发通知都手动粘贴令牌,可以给测试应用单独设置专属的推送主题:
用编译参数标记测试构建,仅当应用运行在测试构建环境时,主动订阅一个对外不公开的测试专属主题,普通正式用户的安装包根本不会执行这段订阅逻辑,自然收不到该主题下的任何通知:
后续发测试推送时,直接定向给这个内部测试主题发送即可,全程不会触达外部正式用户。// 通过编译参数区分测试/正式构建 const isTestEnvironment = String.fromEnvironment('APP_ENV') == 'test'; if (isTestEnvironment) { // 测试设备订阅专属测试主题 await FirebaseMessaging.instance.subscribeToTopic('internal_test_push'); }
实操避坑提示
- Android物理真机调试时记得关闭应用的电池优化权限,避免系统杀后台导致FCM令牌失效,影响测试送达
- 纯Android模拟器需要预装完整Google Play服务才能生成有效FCM令牌;iOS模拟器无法生成关联真实APNs通道的有效FCM令牌,iOS端的推送测试建议优先用物理调试机
- 不要用全量用户分发的方式发测试内容,哪怕是测试文案也可能被FCM的风控规则判定为垃圾内容,拉低后续正式推送的整体送达率
内容的提问来源于stack exchange,提问作者Ahmed Osama
相关产品推荐
相关产品推荐

