为何服务类应用在Android 8正常运行却在Android 12崩溃？

问题概述 #

复现的后台服务Demo在Android 8上运行正常，但在Android 12启动即崩溃，重启后仍提示：

Clear Cache for Example? Example is closed because the app has a bug. Try clearing the app's cache first and then reopen the app

核心原因 #

Android 8（API 26）到Android 12（API 31）之间，系统对后台服务的限制逐步收紧，Demo的实现未适配这些新规范：

• 后台服务启动方式违规：Android 8及以上禁止直接用startService()启动后台服务，必须调用startForegroundService()，且服务需在5秒内调用startForeground()显示前台通知。Android 12对该规则的校验更严格，违规直接触发崩溃。
• 缺少通知渠道：Android 8+要求前台服务的通知必须关联有效的通知渠道，Android 12若检测到无对应渠道，会抛出异常导致崩溃。
• 权限缺失：Android 12对前台服务的权限检查更严格，未声明FOREGROUND_SERVICE权限会导致启动失败；若适配API 33+，还需POST_NOTIFICATIONS权限并在运行时请求。

修复步骤 #

1. 修正服务启动逻辑
   将启动服务的代码从startService(intent)替换为startForegroundService(intent)，并在服务的onCreate()或onStartCommand()中立即调用startForeground()：

   @Override
   public void onCreate() {
       super.onCreate();
       // 创建关联通知渠道的通知
       Notification notification = new NotificationCompat.Builder(this, "CHANNEL_ID")
               .setContentTitle("后台服务运行中")
               .setContentText("正在执行定时任务")
               .setSmallIcon(R.drawable.ic_notification)
               .build();
       startForeground(1, notification);
   }
   

2. 创建通知渠道
   在应用启动时（如Application类或主Activity的onCreate()）创建通知渠道：

   if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
       NotificationChannel channel = new NotificationChannel(
               "CHANNEL_ID",
               "后台服务通知渠道",
               NotificationManager.IMPORTANCE_DEFAULT
       );
       NotificationManager manager = getSystemService(NotificationManager.class);
       manager.createNotificationChannel(channel);
   }
   

3. 声明必要权限
   在AndroidManifest.xml中添加权限：

   <!-- Android 8+ 前台服务权限 -->
   <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
   <!-- Android 13+ 通知权限（适配更高版本时添加） -->
   <uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
   

   针对Android 13及以上，需在运行时请求POST_NOTIFICATIONS权限。

4. 查看崩溃日志定位细节
   通过Android Studio的Logcat筛选应用包名的崩溃信息，搜索AndroidRuntime标签，查看具体异常堆栈（如IllegalStateException或NotificationChannelNotFoundException），精准定位未适配的代码点。

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