Android应用开机自启动Service失败问题求助

我开发了一款Android应用，想要实现系统开机后自动启动Service连接WebSocket服务器，并在合适时机发送通知。但写完代码后，服务器日志里看不到连接记录，而且应用也没法在开机时启动Service，核心代码如下：

1. AndroidManifest.xml 配置 #

<!--permission-->
<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED"/>
<!--receiver -->
<receiver android:name=".service.StartNotificationReceiver"
          android:exported="true">
    <intent-filter android:priority="100">
        <action android:name="android.intent.action.BOOT_COMPLETED"/>
        <category android:name="android.intent.category.HOME"/>
    </intent-filter>
</receiver>
<!--service-->
<service android:name=".service.NotificationService"/>

2. NotificationService.java 代码 #

package com.xxxx.xxxx.service;

public class NotificationService extends Service {

@Nullable
@Override
public IBinder onBind(Intent intent) {
    return null;
}

@Override
public void onCreate() {
    super.onCreate();
}

@Override
public int onStartCommand(Intent intent, int flags, int startId) {
    return super.onStartCommand(intent, flags, startId);
}

@Override
public void onDestroy() {
    super.onDestroy();
}

private void createChannel(){
}

private void sendNotification(String title,String content){
}
}

3. StartNotificationReceiver.java 代码 #

package com.ecsoft.zyymaintain.service;

public class StartNotificationReceiver extends BroadcastReceiver {

static final String ACTION = "android.intent.action.BOOT_COMPLETED";

@Override
public void onReceive(Context context, Intent intent) {
    Log.e("sot","onReceive:"+intent.getAction());
    if (ACTION.equals(intent.getAction())){ 
        Intent intentService = new Intent(context, NotificationService.class);
        context.startService(intentService);
    }
}
}

问题排查与修复步骤 #

一、开机启动失败修复

1. 系统权限与自启动设置

   • Android 8.0+版本，需引导用户手动开启应用的自启动权限，多数厂商系统默认限制未授权应用的开机自启。
   • 确保应用至少被手动启动过一次，未启动过的应用无法接收BOOT_COMPLETED广播（部分系统限制）。

2. BroadcastReceiver配置修正

   • 移除<intent-filter>中的<category android:name="android.intent.category.HOME"/>，开机广播不需要该类别，多余配置会导致广播匹配失败。
   • Android 12+版本，需给Receiver添加android:enabled="true"属性，确保组件可被系统唤醒。

3. Service启动方式适配

   • Android 8.0（API 26）起，startService()被后台限制，需改用startForegroundService()，且Service启动后5秒内必须调用startForeground()显示前台通知，否则会被系统终止。修改Receiver代码：

     Intent intentService = new Intent(context, NotificationService.class);
     if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
         context.startForegroundService(intentService);
     } else {
         context.startService(intentService);
     }
     

   • 在NotificationService的onCreate()中实现前台通知初始化：

     @Override
     public void onCreate() {
         super.onCreate();
         createChannel();
         // 创建前台通知
         Notification notification = new NotificationCompat.Builder(this, "BOOT_SERVICE_CHANNEL")
                 .setContentTitle("后台服务运行中")
                 .setContentText("正在连接服务器")
                 .setSmallIcon(R.drawable.ic_notification)
                 .build();
         startForeground(1, notification);
     }
     

二、WebSocket连接无记录修复

1. 添加WebSocket连接逻辑

   • 当前NotificationService无任何WebSocket连接代码，需在onCreate()中补充连接逻辑（以OkHttp为例）：

     private WebSocket webSocket;
     private void connectWebSocket() {
         OkHttpClient client = new OkHttpClient();
         Request request = new Request.Builder().url("ws://your-server-address").build();
         webSocket = client.newWebSocket(request, new WebSocketListener() {
             @Override
             public void onOpen(WebSocket webSocket, Response response) {
                 Log.d("WebSocket", "连接成功");
                 // 可发送初始化消息到服务器
             }
     
             @Override
             public void onMessage(WebSocket webSocket, String text) {
                 // 收到服务器消息时触发通知
                 sendNotification("新通知", text);
             }
     
             @Override
             public void onFailure(WebSocket webSocket, Throwable t, Response response) {
                 Log.e("WebSocket", "连接失败: " + t.getMessage());
             }
         });
     }
     

   • 记得在build.gradle中添加OkHttp依赖：

     implementation 'com.squareup.okhttp3:okhttp:4.12.0'
     

2. 补充网络权限

   • 在Manifest中添加必要的网络权限：

     <uses-permission android:name="android.permission.INTERNET"/>
     <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
     

3. 处理后台网络限制

   • Android 10+版本，若应用处于后台，需确保已申请后台网络权限，避免系统阻断连接。

三、测试注意事项

• 测试开机启动时，需完全关机再开机，模拟器的"重启"按钮可能不会触发BOOT_COMPLETED广播。
• 国产厂商（小米、华为、OPPO等）有额外后台限制，需引导用户将应用加入"后台保护白名单"。

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