如何在Cordova中启动Android前台服务，解决onStartCommand不触发问题

问题修复方案 #

你遇到的Cordova插件中Android前台服务未触发onStartCommand问题，按照如下步骤排查修复即可：

1. 确认服务已在AndroidManifest.xml中注册

Cordova插件不会自动将自定义Service注册到应用清单文件，需要在插件的plugin.xml中添加配置，打包时自动注入到AndroidManifest：

<platform name="android">
    <config-file target="AndroidManifest.xml" parent="/manifest/application">
        <!-- 替换为你ForegroundService的实际包名 -->
        <service android:name="com.yourpackage.ForegroundService" android:exported="false" />
    </config-file>
    <!-- 声明所需权限 -->
    <config-file target="AndroidManifest.xml" parent="/manifest">
        <!-- Android 9及以上前台服务必要权限 -->
        <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
        <!-- Android 13及以上需要通知权限 -->
        <uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
    </config-file>
</platform>

2. 适配Android 8.0+前台服务启动规则

Android 8.0（API 26）之后禁止后台应用直接调用startService启动后台服务，前台服务必须改用startForegroundService方法，且服务启动后5秒内必须调用startForeground()展示前台通知，否则系统会直接销毁服务，不会触发onStartCommand。

修改你的Cordova启动代码：

// Cordova修改后的启动代码
try {
    Intent runningIntentService = new Intent(cordova.getActivity().getApplicationContext(), ForegroundService.class);
    Log.d("test", "#1");  // gets logged
    cordova.getActivity().stopService(runningIntentService);
    Log.d("test", "#2");  // gets logged
    // 适配不同Android版本启动逻辑
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
        cordova.getActivity().startForegroundService(runningIntentService);
    } else {
        cordova.getActivity().startService(runningIntentService);
    }
    Log.d("test", "#3");  // gets logged
} catch (Exception e) {
    Log.e("test","Error: " + e.toString());
}

同时确认你的ForegroundService的onStartCommand方法中第一时间调用了startForeground展示通知：

@Override
public int onStartCommand(Intent intent, int flags, int startId) {
    // 必须在启动后5秒内调用，参数为唯一通知ID和符合系统要求的通知实例
    startForeground(1, yourBuildedNotification);
    // 后续业务逻辑
    return START_STICKY;
}

3. 额外排查点

• 确认ForegroundService类的包名和Intent构造时传入的类完全一致，没有导错包
• Cordova Android 10+版本需要先动态申请通知权限，再启动前台服务，避免通知展示失败导致服务被销毁

内容的提问来源于stack exchange，提问作者MojioMS