Flutter 如何修复解绑服务时抛出的"Service not registered"类IllegalArgumentException异常
Flutter项目中
ConnectionTracker服务未注册警告的定位与处理 警告本质说明
- 该日志为Google Play服务(GMS)内置模块抛出的非阻断性警告,并非开发者自身业务代码抛出的运行时崩溃,不会导致App直接退出
- 触发来源为GMS动态加载的
measurementdynamite测量模块(对应Firebase Analytics的底层实现),日志栈中的ci/lq/lc等混淆类名均为GMS SDK内部代码,无需排查自身项目的类逻辑 - 异常触发逻辑为GMS内部执行
unbindService解绑服务时,对应服务连接已被提前解绑、未完成有效注册,属于GMS自身的实现边界问题,正常不会导致核心功能失效
定位排查步骤
- 首先确认是否伴随实际功能异常:如App崩溃、Firebase事件上报失败、GMS关联功能(推送、广告标识获取)失效。若无任何功能异常,该警告属于GMS已知内部bug,不影响生产环境运行
- 检查项目原生依赖版本:
- 查看
android/app/build.gradle中引入的play-services-measurement系列依赖,确认是否使用了存在解绑逻辑缺陷的20.42.15旧版本 - 核对
firebase_core、firebase_analytics等Flutter插件的版本,确认其拉取的原生GMS依赖是否存在版本错配
- 查看
- 排查异常触发的逻辑冲突:检查项目中是否存在手动提前销毁Firebase实例、在页面销毁时手动调用Analytics清理接口的逻辑,避免和GMS自身的服务解绑流程产生时序冲突
对应处理方案
- 无功能异常场景:直接过滤该类调试日志即可,无需修改业务代码。可通过日志配置过滤Tag为
ConnectionTracker的GMS警告日志,不影响正常调试流程 - 存在功能异常场景:
- 将所有GMS、Firebase相关的Flutter插件升级至当前稳定的最新版本
- 移除项目中所有手动触发Firebase SDK解绑、服务反初始化的自定义代码
- 对齐Android项目中
google-services插件的版本,避免与引入的GMS依赖出现版本不兼容
- 若项目未使用Firebase Analytics相关能力,可直接移除对应的测量模块依赖,从根源消除该警告的触发条件
内容的提问来源于stack exchange,提问作者marcos_troia
相关产品推荐
相关产品推荐

