Flutter真机运行报"inactivity disconnecting from the service"错误如何解决?
"inactivity disconnecting from the service"
排查步骤
- 首先排查真机系统权限配置:国内安卓厂商(小米、华为、OPPO、vivo等)的定制系统普遍有严格的后台电量限制策略,原生安卓模拟器无该类限制,先确认应用已开启自启动权限、后台活动权限,且已关闭系统对该应用的电池优化。
- 其次排查release打包配置:检查是否已添加推送SDK对应的混淆规则,避免release模式下服务相关代码被裁剪;同时检查
AndroidManifest.xml中通知相关的服务、权限声明是否完整。 - 接着定位触发报错的服务:真机连接电脑运行release包,执行
adb logcat *:E查看完整错误上下文,确认被系统断开的是第三方推送服务还是应用内自定义服务。 - 最后检查安卓版本适配情况:该报错大多出现在安卓12及以上系统,这类系统对后台服务的运行限制非常严格,未适配的后台服务会被系统主动回收。
解决方案
基础适配
- 接入厂商系统推送通道:如果应用面向国内用户,不要仅依赖FCM或第三方应用级推送,接入对应厂商的系统级推送通道后,通知通过厂商系统服务下发,不需要应用自身后台保活,可从根源避免该报错。
- 调整安卓配置:
- 在
AndroidManifest.xml中为推送服务添加前台服务类型声明:
<service android:name="你使用的推送服务全类名" android:exported="false" android:foregroundServiceType="remoteMessage|dataSync" />- 在
android/app/proguard-rules.pro中添加对应推送SDK的混淆规则,避免release打包时服务类被移除。 - 应用首次启动时主动申请加入电池优化白名单,申请通过后系统不会主动清理应用的后台服务。
- 在
场景化修复
- 若使用Flutter推送相关插件(如
firebase_messaging、flutter_local_notifications),直接升级到插件的最新稳定版,旧版本普遍存在安卓高版本后台服务适配缺陷,升级后大部分场景可直接解决问题。 - 若应用本身需要长期运行后台自定义服务,将服务设置为前台服务,配合常驻通知展示,安卓系统不会主动回收前台服务。
内容的提问来源于stack exchange,提问作者Yiğit Yeşilada
相关产品推荐
相关产品推荐

