Android Foreground Service 深挖（服务类型、通知约束与高版本后台限制）

回到总览：异步后台任务、保活、系统能力
相关模块：WorkManager / ForegroundService / AlarmManager 对比 · Doze 深度休眠模式与国内厂商后台限制

一句话定义

Foreground Service（前台服务）是 Android 用于承载“用户显式感知且不可中断的长耗时任务”（如音视频播放、导航、录音、数据同步）的系统组件；它必须关联常驻通知，且在 Android 12+ / 14+ 受到严苛的启动限制与强制类型（foregroundServiceType）声明约束。

代码索引

计划补齐的实验：
labs/android/host/topics/background-tasks/foreground-service-demo/ — FGS 类型声明、Android 14 凭据申请与后台启动限制测试

为什么需要

为什么在 Android 12+ 上，后台广播或线程里直接调用 startForegroundService() 会抛出 ForegroundServiceStartNotAllowedException？
- 一句话答：为防止应用滥用前台服务保活和偷偷消耗资源，Android 12+ 引入了后台启动 FGS 限制（Background Start Restriction），除非处于例外场景（如收到高优先级 FCM 推送、用户点击通知、获得特定权限），应用退到后台后严禁直接启动 FGS。
为什么 10 年 Android 工程师迁移 Flutter 时必须处理好前台服务？
- 一句话答：Flutter 在退后台后 Dart Isolate 随时可能被系统冻结；对于导航、音频播放或下载等长耗时业务，必须在 Android 宿主侧通过 FGS 维持进程活跃并持有系统 WakeLock。

底层机制

1. Android 14+ 强制 FGS 类型 (Foreground Service Types) 声明

Android 14 (API 34) 强制要求在 AndroidManifest.xml 中为每个 FGS 声明具体类型，并在 runtime 申请对应权限：

xml

<!-- 必须声明 FGS 权限 -->
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<!-- Android 14+ 必须追加特定类型的专属权限 -->
<uses-permission android:name="android.permission.FOREGROUND_SERVICE_MEDIA_PLAYBACK" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE_LOCATION" />

<application>
    <service
        android:name=".MyMediaService"
        android:foregroundServiceType="mediaPlayback"
        android:exported="false" />
</application>

常见的 FGS 类型限制一览

`foregroundServiceType`	允许的典型业务场景	专属权限需求	运行时行为/限制
`camera`	相机录制、视频通话	`FOREGROUND_SERVICE_CAMERA`	退后台不可启动，必须前台启动
`location`	骑行导航、实时定位	`FOREGROUND_SERVICE_LOCATION`	需要位置权限支持
`mediaPlayback`	音乐播放器、播客	`FOREGROUND_SERVICE_MEDIA_PLAYBACK`	必须关联 `MediaSession` 控制
`dataSync`	断点上传下载、文件同步	`FOREGROUND_SERVICE_DATA_SYNC`	Android 14+ 增加 6 小时运行上限
`shortService`	超短时急迫任务	无需特殊类型	最大运行 3 分钟，超时强制杀死

2. 启动与通知绑定流程 (`startForeground`)

在 Service 启动后的 10 秒钟内，必须调用 startForeground() 绑定前台通知，否则系统会抛出 RemoteServiceException 闪退崩溃：

java

public class MyMediaService extends Service {
    private static final int NOTIFICATION_ID = 1001;
    private static final String CHANNEL_ID = "media_playback_channel";

    @Override
    public int onStartCommand(Intent intent, int flags, int startId) {
        createNotificationChannel();
        
        // 构建用户显式感知的通知
        Notification notification = new NotificationCompat.Builder(this, CHANNEL_ID)
                .setContentTitle("正在播放音频")
                .setContentText("点击返回应用")
                .setSmallIcon(R.drawable.ic_music)
                .setPriority(NotificationCompat.PRIORITY_LOW)
                .build();

        // 绑定前台服务与通知 (Android 14+ 传类型)
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
            startForeground(NOTIFICATION_ID, notification, ServiceInfo.FOREGROUND_SERVICE_TYPE_MEDIA_PLAYBACK);
        } else {
            startForeground(NOTIFICATION_ID, notification);
        }

        return START_STICKY;
    }
}

Android / Flutter / Web / Backend 对照

维度	Android 原生 (FGS)	Flutter 插件	iOS 宿主
后台长耗时	靠 `ForegroundService` 保持	靠 `flutter_foreground_task` 调原生 FGS	靠 `UIBackgroundModes` (Audio/Location)
用户感知	强感知（通知栏常驻 Notification）	同左（在宿主 Android 侧弹出）	顶部状态栏变蓝/变红指示
启动限制	Android 12+ 后台禁止启动 FGS	必须在应用在前台时提前启动	严格按 Background Mode 类型审核

常见场景

1. 适配 Android 12+ 允许后台启动 FGS 的例外情况

虽然 Android 12+ 禁止后台启动 FGS，但以下情况依然被允许：

收到高优先级 FCM / 极光推送消息。
用户在通知栏点击了 Action 按钮。
应用拥有 START_ACTIVITIES_FROM_BACKGROUND 特许权限。
伴随设备（Companion Device）绑定状态。

常见误配、事故后果与排障

1. 事故：Android 14 设备上未声明 `foregroundServiceType` 直接 Crash

误配原因：目标版本升级到 targetSdkVersion 34，调用 startForeground() 时未在 Manifest 声明 foregroundServiceType 或未动态申请 FOREGROUND_SERVICE_xxx 权限。
后果：直接抛出 SecurityException: Starting FGS without permission 导致 Crash。
排障与修法：Target 34+ 必须按业务显式声明特定类型与权限，若为临时同步务必使用 shortService 或迁移至 WorkManager。

与相近概念对比

组件	是否有通知	是否会被 Doze 杀死	适合的场景
Foreground Service	是 (常驻)	否 (维持高优先级进程)	音乐播放、导航、蓝牙连接、实时录音
Background Service	否	是 (Android 8.0+ 禁止常驻)	已废弃，不要再使用！
WorkManager	否 (除非设 Expedited)	否 (由系统自动调度)	延迟日志上报、周期性数据同步

对应实验

计划补齐的实验：

labs/android/host/topics/background-tasks/foreground-service-demo/ — FGS 类型声明、Android 14 凭据申请与后台启动限制测试

复习检查题

在 Android 8.0 及以上版本中，调用 context.startForegroundService() 后如果不调用 startForeground() 会发生什么？
答：如果在 startForegroundService() 启动服务后的规定时间内（通常为 5~10 秒内）没有调用 startForeground() 绑定常驻通知，系统会认为该服务试图在后台偷偷运行，并直接抛出 ANR 或 android.app.RemoteServiceException: Context.startForegroundService() did not then call Service.startForeground() 导致应用闪退。
Android 14 对 dataSync 类型的 Foreground Service 增加了什么重要限制？推荐替代方案是什么？
答：Android 14 对 dataSync（数据同步）类型的 FGS 增加了累计运行 6 小时的硬性时间上限。当运行时间达到上限时，系统会回调 Service.onTimeout() 给予少量时间收尾，之后强制终止该服务。对于长耗时的数据同步，推荐迁移到 WorkManager 或 JobScheduler。

速记

通知绑定：启动必须 10 秒内调 startForeground 挂通知，否则报错闪退。
12+ 限制：后台严禁随意启动 FGS，除非推送或用户主动点击触发。
14+ 约束：Manifest 必须精细化声明 foregroundServiceType 及专属权限。

Android Foreground Service 深挖（服务类型、通知约束与高版本后台限制） ​

一句话定义 ​

代码索引 ​

为什么需要 ​

底层机制 ​

1. Android 14+ 强制 FGS 类型 (Foreground Service Types) 声明 ​

常见的 FGS 类型限制一览 ​

2. 启动与通知绑定流程 (startForeground) ​

Android / Flutter / Web / Backend 对照 ​

常见场景 ​

1. 适配 Android 12+ 允许后台启动 FGS 的例外情况 ​

常见误配、事故后果与排障 ​

1. 事故：Android 14 设备上未声明 foregroundServiceType 直接 Crash ​

与相近概念对比 ​

对应实验 ​

复习检查题 ​

速记 ​