Android 12/13出现BackgroundServiceStartNotAllowedException问题求助

异常核心原因 #

Android 12（API 31）及以上版本对后台服务启动施加了更严格的限制：应用处于后台状态时，禁止调用startService()。即便代码写在onResume()方法中，也可能因特定场景触发系统限制。

具体排查方向与修复方案 #

1. 校验服务运行状态的逻辑是否可靠

你当前通过CustomSystem.isUpdateServiceStarted()和静态变量UpdateService.started判断服务状态，存在两个关键问题：

• 静态变量会在进程被系统回收后重置，容易导致服务状态误判
• CustomSystem的判断逻辑可能存在延迟或错误，比如服务刚被杀死但判断仍返回“已启动”，反之亦然
• 修复方案：替换为更可靠的服务状态查询方式，例如通过ActivityManager校验：

  private boolean isUpdateServiceRunning() {
      ActivityManager am = (ActivityManager) getSystemService(Context.ACTIVITY_SERVICE);
      for (ActivityManager.RunningServiceInfo service : am.getRunningServices(Integer.MAX_VALUE)) {
          if (UpdateService.class.getName().equals(service.service.getClassName())) {
              return true;
          }
      }
      return false;
  }
  

2. onResume()不代表应用一定处于前台

Android 12+中，以下场景下Activity会调用onResume()，但应用实际处于后台状态：

• 被其他应用的透明/半透明Activity（如悬浮窗、权限弹窗）覆盖
• 处于多窗口模式的非活跃窗口
• 修复方案：启动服务前先校验应用是否在前台：

  private boolean isAppForeground() {
      ActivityManager am = (ActivityManager) getSystemService(Context.ACTIVITY_SERVICE);
      List<ActivityManager.RunningAppProcessInfo> processes = am.getRunningAppProcesses();
      if (processes == null) return false;
      for (ActivityManager.RunningAppProcessInfo info : processes) {
          if (info.processName.equals(getPackageName()) && info.importance == ActivityManager.RunningAppProcessInfo.IMPORTANCE_FOREGROUND) {
              return true;
          }
      }
      return false;
  }
  

  在调用startService()前增加判断：if (isAppForeground()) { ... }

3. 适配Android 8+的前台服务要求

从Android 8（API 26）开始，后台启动服务必须使用startForegroundService()，且服务需在5秒内调用startForeground()显示通知。你当前使用startService()的方式，在Android12+的严格限制下会直接触发异常：

• 修复方案：替换服务启动方式，并完善服务的前台逻辑：

  // BaseActivity中修改启动代码
  @Override
  protected void onResume() {
      super.onResume();
      if (!isUpdateServiceRunning()) {
          Intent serviceIntent = new Intent(this, UpdateService.class);
          if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
              startForegroundService(serviceIntent);
          } else {
              startService(serviceIntent);
          }
          // 剩余定时器逻辑...
      } else {
          UpdateService.wakeUp(BaseActivity.this);
      }
  }
  

  在UpdateService中添加前台服务逻辑：

  @Override
  public void onCreate() {
      super.onCreate();
      if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
          // 创建通知通道（Android8+必须）
          NotificationChannel channel = new NotificationChannel("update_service", "更新服务", NotificationManager.IMPORTANCE_LOW);
          NotificationManager nm = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE);
          if (nm != null) nm.createNotificationChannel(channel);
          // 启动前台服务
          Notification notification = new NotificationCompat.Builder(this, "update_service")
                  .setSmallIcon(R.drawable.ic_service_notify)
                  .setContentTitle("更新服务运行中")
                  .setContentText("正在检查应用更新")
                  .build();
          startForeground(1001, notification);
      }
  }
  

4. 替换为更合规的后台任务方案

如果你的服务仅用于后台更新检查，建议改用WorkManager替代后台服务——这是Google官方推荐的适配全版本后台限制的方案，无需手动处理服务启动的权限和限制问题。

额外权限声明 #

在AndroidManifest.xml中添加前台服务权限：

<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<!-- 若为数据同步类服务，可使用更具体的权限： -->
<uses-permission android:name="android.permission.FOREGROUND_SERVICE_DATA_SYNC" />

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