先讲我之前踩的一个足以打回版本的大坑。项目需求是后台持续采集传感器数据,一开始我用 WorkScheduler,发现它满足不了实时性,周期太长还容易被系统延后。那自然想到前台服务,当时想当然:开个前台服务,挂一条通知,就能永久保活了。 结果真机测试,熄屏跑一会儿直接被杀;更头疼的是提交应用市场审核直接驳回,理由是前台服务用途不合规、通知无法关闭。 直到我仔细梳理 HarmonyOS7 对前台服务的管控规则才明白:前台服务不是万能保活黑科技,它是 “带通知、用户知情、有明确业务场景” 的能力,系统依然会做资源管控,同时审核对使用场景有硬性白名单限制。 这篇就从这个误区切入,把前台服务的适用边界、通知配置、生命周期、权限、被杀场景、审核雷区一次性讲透,附带可直接运行代码,全部是项目复盘沉淀下来的实操经验。

先回答核心问题:我们什么时候才需要用 ForegroundService? 先区分清楚几个后台方案的边界,避免一需要后台就直接上前台服务:

  • WorkScheduler:机会型调度,低频次、不要求准时,最小周期 30 分钟,没有常驻通知;
  • 普通 ExtensionAbility:无通知后台,极易被系统冻结、回收,不适合持续任务;
  • ForegroundService 前台服务:绑定一条持续可见的系统通知,告知用户 App 正在后台运行,拿到更高的后台优先级,适合持续运行的业务。

划重点!官方允许的前台服务场景是有限的,不是什么业务都能开: ✅ 合规场景:导航定位、音频播放、运动健康采集、蓝牙设备持续连接、文件持续传输、拍照 / 扫码持续预览。 ❌ 不合规场景:单纯的定时同步、埋点上报、缓存清理、消息轮询。这类场景强行开前台服务,审核 100% 驳回。 这是很多开发者最大的翻车点:技术上能跑通,但过不了应用市场审核。

还有一句一定要刻在脑子里:前台服务只是提升进程优先级,不等于永不被杀。内存极度紧张、超级省电模式开启、用户手动关闭通知权限、手动在通知栏停止服务,进程依旧会终止。

接下来看基础实现,HarmonyOS7 中前台服务基于 ForegroundServiceExtensionAbility。 第一步,新建前台服务文件 SensorForegroundService.ets

import { ForegroundServiceExtensionAbility, foregroundService, notificationManager } from '@kit.BackgroundTasksKit';
import hilog from '@ohos.hilog';

export default class SensorForegroundService extends ForegroundServiceExtensionAbility {
  // 服务创建回调
  onCreate(): void {
    hilog.info(0x0003, "FgDemo", "前台服务 onCreate");
    super.onCreate();
  }

  // 服务启动入口,业务在这里启动
  onStart(): void {
    hilog.info(0x0003, "FgDemo", "前台服务 onStart,开始执行业务");
    super.onStart();
    // 启动前台,绑定通知,这一步是核心!不调用startForeground,它就不是前台服务
    this.startMyForeground();
    // 启动你的持续业务:传感器、蓝牙、上传任务
    this.startSensorCollect();
  }

  // 启动前台绑定通知
  async startMyForeground() {
    try {
      // 1. 先创建通知通道(鸿蒙必须先有通道)
      const notificationRequest: notificationManager.NotificationRequest = {
        id: 10086,
        notificationSlotType: notificationManager.SlotType.SERVICE_INFORMATION,
        content: {
          notificationContentType: notificationManager.ContentType.NOTIFICATION_CONTENT_BASIC_TEXT,
          normal: {
            title: "传感器采集服务",
            text: "正在后台持续采集运动数据"
          }
        }
      };
      // 发布通知
      await notificationManager.publish(notificationRequest);

      // 2. 将当前服务绑定这个通知,升级为前台服务
      const fgInfo: foregroundService.ForegroundServiceInfo = {
        notificationId: 10086,
        foregroundServiceType: foregroundService.ForegroundServiceType.SENSOR
      };
      foregroundService.startForeground(this.context, fgInfo);
      hilog.info(0x0003, "FgDemo", "前台服务绑定通知成功");
    } catch (err) {
      hilog.error(0x0003, "FgDemo", "启动前台失败 %j", err);
    }
  }

  // 模拟持续业务:传感器采集
  startSensorCollect() {
    // 这里替换成传感器、蓝牙、文件传输等真实逻辑
    // 注意:这里如果是循环任务,一定要做好终止标记!
    this.collectLoop();
  }

  private isRunning: boolean = true;
  async collectLoop() {
    if (!this.isRunning) return;
    hilog.info(0x0003, "FgDemo", "采集一轮数据");
    await new Promise(resolve => setTimeout(resolve, 1000));
    this.collectLoop();
  }

  // 停止服务回调:用户点击通知停止、系统回收时触发
  onStop(): void {
    hilog.info(0x0003, "FgDemo", "前台服务收到停止信号");
    this.isRunning = false;
    // 释放硬件资源:传感器、蓝牙、句柄
    super.onStop();
    // 移除前台绑定
    foregroundService.stopForeground(this.context);
    // 取消通知
    notificationManager.cancel(10086);
  }

  onDestroy(): void {
    hilog.info(0x0003, "FgDemo", "前台服务销毁");
    this.isRunning = false;
    super.onDestroy();
  }
}

第二步,module.json5 注册这个 ExtensionAbility,这个配置漏写直接无法拉起服务:

"extensionAbilities": [
  {
    "name": "SensorForegroundService",
    "srcEntry": "./ets/SensorForegroundService.ets",
    "type": "foregroundService",
    "export": true
  }
]

第三步,页面里面拉起、停止前台服务的调用代码:

import { foregroundService } from '@kit.BackgroundTasksKit';
import hilog from '@ohos.hilog';

@Entry
@ComponentV2
struct FgServicePage {
  // 启动前台服务
  startFgService() {
    try {
      foregroundService.startForegroundService(this.getUIContext(), "SensorForegroundService");
      hilog.info(0x0003, "FgDemo", "发起启动前台服务请求");
    } catch (err) {
      hilog.error(0x0003, "FgDemo", "拉起前台服务失败 %j", err);
    }
  }

  // 停止前台服务
  stopFgService() {
    try {
      foregroundService.stopForegroundService(this.getUIContext(), "SensorForegroundService");
      hilog.info(0x0003, "FgDemo", "发起停止前台服务请求");
    } catch (err) {
      hilog.error(0x0003, "FgDemo", "停止前台服务失败 %j", err);
    }
  }

  build() {
    Column({ space: 20 }) {
      Button("启动后台采集服务")
        .onClick(() => this.startFgService())
      Button("停止后台采集服务")
        .onClick(() => this.stopFgService())
    }
    .padding(30)
    .width('100%')
    .height('100%')
  }
}

第四步,权限声明!两个必选权限,少一个都无法正常运行:

"requestPermissions": [
  {
    "name": "ohos.permission.FOREGROUND_SERVICE",
    "reason": "用于开启前台服务,后台持续采集传感器数据",
    "usedScene": {
      "abilities": ["SensorForegroundService"],
      "when": "inuse"
    }
  },
  {
    "name": "ohos.permission.NOTIFICATION_CONTROL",
    "reason": "前台服务需要发布常驻通知",
    "usedScene": {
      "abilities": ["SensorForegroundService"],
      "when": "inuse"
    }
  }
]

重点字段解释:

  1. foregroundServiceType:这个字段是审核的重中之重!必须匹配你的真实业务。
    • SENSOR:传感器采集
    • AUDIO_PLAYBACK:音频播放
    • LOCATION:导航定位
    • BLUETOOTH:蓝牙持续连接 你如果做音频播放,却写 SENSOR,审核会判定类型和业务不匹配,直接驳回。
  2. startForeground:必须在 onStart 里面调用,并且绑定一条可见通知。没有通知的,不叫前台服务,系统不会给进程保活优先级。
  3. 通知是用户可感知的:用户可以下拉通知栏,点击通知里的停止按钮终止服务,这个逻辑是系统自带的,你无法屏蔽。

接下来是我项目里踩过的高频大坑,按权重排序:

坑 1:前台服务类型乱填,和业务不匹配,版本审核驳回 很多人为了省事,随便选一个类型。HarmonyOS7 的审核系统会校验前台服务类型和你的权限、功能描述。比如纯蓝牙业务不能标记为 LOCATION。 ✅ 规范:业务是什么,就选对应的 ForegroundServiceType,不要混用。

坑 2:忘记在 onStop 里面释放硬件资源,资源泄漏 传感器、蓝牙、串口这类硬件资源,如果服务停止的时候不主动关闭,就算服务销毁,硬件句柄依旧占用,再次启动会直接打开失败。 ✅ 铁律:onStop 是唯一可靠的回收入口,循环任务标记停止位,硬件资源在这里释放。

坑 3:通知无法取消,服务停了通知还留在通知栏 停止服务的时候,只调用 stopForegroundService,忘记调用 notificationManager.cancel。 现象:服务已经停了,通知一直挂在通知栏,用户以为 App 还在后台运行,投诉非常多。 ✅ 标准流程:停止服务 → stopForeground 解绑 → cancel 取消通知。

坑 4:在前台服务里面操作 UI、调用路由跳转 ForegroundServiceExtensionAbility 没有 UI 上下文,不能使用 router、不能打开页面、不能操作 ArkUI 组件。一旦写了路由跳转,直接崩溃。 如果需要通知点击跳转页面,要在通知的 request 里面设置点击意图。

坑 5:循环任务没有停止标记,被系统强杀后出现异常 很多人直接写死 while (true) 循环,没有 isRunning 标记。系统触发 onStop 的时候,循环还在跑,出现异常报错。 ✅ 所有持续循环,都必须加一个布尔停止标记,onStop 的时候置为 false。

坑 6:多进程、重复启动前台服务,通知 ID 冲突 同一个通知 id,重复发布,通知内容会被覆盖;不同前台服务不要共用同一个 notificationId。 ✅ 不同业务的前台服务,通知 ID 单独分配,做好管理。

坑 7:预览器调试无效,只有真机才能完整验证 预览器不支持前台服务 + 常驻通知的完整链路。调试必须上真机,并且打开通知权限。 同时测试场景要覆盖:熄屏、省电模式、超级省电模式,不同场景存活能力差异巨大。

坑 8:误以为前台服务可以绕过隐私权限 比如后台定位,就算开了 LOCATION 类型前台服务,定位权限依旧需要用户授权,后台定位还需要额外的后台位置权限,前台服务不具备 “绕过权限” 的特权。

坑 9:通知文案含糊不清,审核判定误导用户 通知文本不能写 “后台服务运行中” 这种模糊描述,必须清晰说明用途,例如:“正在后台采集运动传感器数据”,审核会检查通知文案。

这里整理一张对比表,帮你快速区分前台服务和 WorkScheduler:

表格

特性ForegroundService 前台服务WorkScheduler
用户感知常驻通知,用户可见,可手动停止无通知,静默执行
执行能力支持持续长任务,实时性强机会型任务,最小周期 30 分钟
保活能力优先级更高,但非永久极易被延后、跳过
审核约束严格,有服务类型白名单宽松,只要用途合理
用户划掉 App大部分机型会终止任务直接清空
适合场景导航、音频播放、蓝牙长连、传感器持续采集日志上报、缓存清理、定时同步

下面是审核红线清单,提交版本之前自查一遍:

  1. 前台服务用途是否在官方白名单内?
  2. foregroundServiceType 和业务是否一一对应?
  3. 通知标题、内容是否清晰说明服务作用?
  4. 是否提供用户主动停止服务的入口(通知栏按钮 + 页面内按钮)?
  5. 服务停止后,通知是否同步移除?
  6. 硬件资源、循环任务在 onStop 是否正常释放终止?
  7. 有没有在前台服务里面做不合规的后台轮询、消息拉取?

最后复盘总结: 前台服务的本质,是“用户知情前提下,给持续运行的合法业务提升进程优先级”。 它不是保活神器,更不能用来实现偷偷后台跑任务。很多开发踩坑,本质就是预期错配:想用它做一个不需要用户感知、静默常驻的后台轮询,这既过不了审核,也违背鸿蒙后台管控的设计初衷。 如果你的业务不需要持续运行、不需要实时,优先选择 WorkScheduler;只有属于官方允许的前台场景,再考虑 ForegroundService。

Logo

作为“人工智能6S店”的官方数字引擎,为AI开发者与企业提供一个覆盖软硬件全栈、一站式门户。

更多推荐