You need to enable JavaScript to run this app. Flutter真机运行报"inactivity disconnecting from the service"错误如何解决?
优惠活动
大模型
产品
解决方案
定价
更多

Flutter真机运行报"inactivity disconnecting from the service"错误如何解决?

"inactivity disconnecting from the service"

排查步骤
  • 首先排查真机系统权限配置:国内安卓厂商(小米、华为、OPPO、vivo等)的定制系统普遍有严格的后台电量限制策略,原生安卓模拟器无该类限制,先确认应用已开启自启动权限、后台活动权限,且已关闭系统对该应用的电池优化。
  • 其次排查release打包配置:检查是否已添加推送SDK对应的混淆规则,避免release模式下服务相关代码被裁剪;同时检查AndroidManifest.xml中通知相关的服务、权限声明是否完整。
  • 接着定位触发报错的服务:真机连接电脑运行release包,执行adb logcat *:E查看完整错误上下文,确认被系统断开的是第三方推送服务还是应用内自定义服务。
  • 最后检查安卓版本适配情况:该报错大多出现在安卓12及以上系统,这类系统对后台服务的运行限制非常严格,未适配的后台服务会被系统主动回收。
解决方案

基础适配

  • 接入厂商系统推送通道:如果应用面向国内用户,不要仅依赖FCM或第三方应用级推送,接入对应厂商的系统级推送通道后,通知通过厂商系统服务下发,不需要应用自身后台保活,可从根源避免该报错。
  • 调整安卓配置:
    1. 在AndroidManifest.xml中为推送服务添加前台服务类型声明:
    <service
        android:name="你使用的推送服务全类名"
        android:exported="false"
        android:foregroundServiceType="remoteMessage|dataSync" />
    
    1. 在android/app/proguard-rules.pro中添加对应推送SDK的混淆规则,避免release打包时服务类被移除。
    2. 应用首次启动时主动申请加入电池优化白名单,申请通过后系统不会主动清理应用的后台服务。

场景化修复

  • 若使用Flutter推送相关插件(如firebase_messaging、flutter_local_notifications),直接升级到插件的最新稳定版,旧版本普遍存在安卓高版本后台服务适配缺陷,升级后大部分场景可直接解决问题。
  • 若应用本身需要长期运行后台自定义服务,将服务设置为前台服务,配合常驻通知展示,安卓系统不会主动回收前台服务。

内容的提问来源于stack exchange,提问作者Yiğit Yeşilada

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.14 16:06:02