Android开机自动启动Kotlin应用失败问题排查与解决

问题原因分析 #

核心问题有两点：

1. 广播接收器未对外暴露：Manifest里的BootCompleteReceiver设置了android:exported="false"，而系统发送的ACTION_BOOT_COMPLETED广播来自外部系统进程，接收器必须对外暴露才能正常接收处理该广播（虽当前Toast能显示，但此配置本身不符合规范）。
2. Android 10+后台启动Activity限制：从Android 10（API 29）开始，系统严格限制后台应用直接启动Activity，仅靠FLAG_ACTIVITY_NEW_TASK无法绕过该限制。

修复步骤及代码调整 #

1. 修正Manifest中的广播接收器配置 #

将接收器的android:exported改为true，同时移除不必要的category配置（ACTION_BOOT_COMPLETED广播不需要DEFAULT类别）：

<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
<!-- Android 10+需添加的权限 -->
<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />
<uses-permission android:name="android.permission.REQUEST_IGNORE_BATTERY_OPTIMIZATIONS" />

<receiver
    android:name=".BootCompleteReceiver"
    android:exported="true"
    android:permission="android.permission.RECEIVE_BOOT_COMPLETED">
    <intent-filter android:priority="1000">
        <action android:name="android.intent.action.BOOT_COMPLETED" />
    </intent-filter>
</receiver>

2. 适配Android 10+的Activity启动限制 #

修改BootCompleteReceiver代码，针对不同版本做适配：

• Android 9及以下：保留原有启动逻辑
• Android 10及以上：先启动前台服务，再通过服务启动Activity

修改后的Receiver代码

class BootCompleteReceiver : BroadcastReceiver() {
    override fun onReceive(context: Context?, intent: Intent?) {
        if (intent?.action == Intent.ACTION_BOOT_COMPLETED) {
            Toast.makeText(context, "Boot Completed", Toast.LENGTH_LONG).show()
            context?.let { ctx ->
                val mainIntent = Intent(ctx, MainActivity::class.java).apply {
                    flags = Intent.FLAG_ACTIVITY_NEW_TASK or Intent.FLAG_ACTIVITY_CLEAR_TOP
                }

                if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
                    // Android 10+ 先启动前台服务再启动Activity
                    val serviceIntent = Intent(ctx, BootStartService::class.java).apply {
                        putExtra("mainIntent", mainIntent)
                    }
                    ContextCompat.startForegroundService(ctx, serviceIntent)
                } else {
                    // Android 9及以下直接启动Activity
                    ctx.startActivity(mainIntent)
                }
            }
        }
    }
}

// 新增前台服务类
class BootStartService : Service() {
    override fun onStartCommand(intent: Intent?, flags: Int, startId: Int): Int {
        // 创建前台通知（Android 8+要求必须显示通知才能启动前台服务）
        val notification = NotificationCompat.Builder(this, "BOOT_CHANNEL_ID")
            .setSmallIcon(R.drawable.ic_launcher_foreground)
            .setContentTitle("应用启动中")
            .setContentText("正在启动应用")
            .setPriority(NotificationCompat.PRIORITY_LOW)
            .build()

        startForeground(1, notification)

        // 启动目标Activity
        intent?.getParcelableExtra<Intent>("mainIntent")?.let {
            startActivity(it)
        }

        // 启动完成后停止服务
        stopSelf()
        return START_NOT_STICKY
    }

    override fun onBind(intent: Intent?): IBinder? = null
}

3. 注册前台服务并创建通知渠道（Android 8+） #

在Manifest中注册新增的BootStartService：

<service
    android:name=".BootStartService"
    android:exported="false"
    android:foregroundServiceType="dataSync|mediaPlayback" />

在MainActivity的onCreate中添加通知渠道创建逻辑：

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    // Android 8+ 创建通知渠道
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
        val channel = NotificationChannel(
            "BOOT_CHANNEL_ID",
            "开机启动通知",
            NotificationManager.IMPORTANCE_LOW
        ).apply {
            description = "用于开机启动应用的前台通知"
        }
        val notificationManager = getSystemService(NotificationManager::class.java)
        notificationManager.createNotificationChannel(channel)
    }
    setContent {
        AutoBootTheme {
            Surface(
                modifier = Modifier.fillMaxSize(),
                color = MaterialTheme.colorScheme.background
            ) {
                Greeting("Android")
            }
        }
    }
}

4. 额外注意事项 #

• Android 12及以上，需给MainActivity添加android:exported="true"：

<activity
    android:name=".MainActivity"
    android:exported="true"
    android:theme="@style/Theme.AutoBoot">
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
</activity>

• 测试前需手动启动应用至少一次（Android 6.0+要求应用首次安装后需手动启动才能接收开机广播）。
• 部分定制系统（如小米、华为）有额外后台限制，需引导用户开启「自启动权限」和「允许后台启动Activity」权限。

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