BroadcastReceiver接收蓝牙连接广播后调用startActivity无法启动MainActivity问题

• 最常见触发场景：Android 10（API 级别 29）及以上系统引入了后台启动Activity的限制，默认禁止后台应用在没有用户交互的情况下直接启动Activity，即便调用了startActivity也会被系统静默拦截，这就是你能看到启动请求日志但看不到MainActivity onCreate日志的核心原因。
• 其他可能原因：
  • Android 12及以上系统未正确声明android.permission.BLUETOOTH_CONNECT等运行时权限，导致蓝牙广播相关逻辑触发后续操作被拦截
  • AndroidManifest.xml中MainActivity的android:exported属性未显式设置为true（Android 12及以上要求四大组件必须显式声明exported属性，否则无法被外部组件启动）
  • 小米、华为、OPPO等国产定制ROM额外限制了应用的后台启动、自启动权限，即便原生系统权限满足也会被厂商拦截
  • MainActivity配置了特殊的启动模式、任务栈关联规则，导致新启动的实例被合并到后台任务栈没有展示到前台

1. 适配系统后台启动Activity限制（必须配置） #

Android 10及以上要实现后台启动Activity，需要申请悬浮窗特殊权限：
首先在AndroidManifest.xml中添加权限声明：

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

在应用首次启动时引导用户开启悬浮窗权限：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M && !Settings.canDrawOverlays(context)) {
    Intent intent = new Intent(Settings.ACTION_MANAGE_OVERLAY_PERMISSION, 
        Uri.parse("package:" + context.getPackageName()));
    intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
    context.startActivity(intent);
}

2. 检查Activity注册配置 #

确认AndroidManifest.xml中MainActivity的exported属性配置正确：

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

3. 补充蓝牙相关权限（Android 12+必须） #

在AndroidManifest.xml中添加蓝牙相关权限：

<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
<uses-permission android:name="android.permission.BLUETOOTH" android:maxSdkVersion="30" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" android:maxSdkVersion="30" />

并在运行时动态申请BLUETOOTH_CONNECT权限。

4. 适配国产定制ROM权限 #

针对小米、华为等设备，需要引导用户在系统设置中开启应用的「自启动权限」、「后台弹出界面权限」、「允许后台活动」等厂商定制权限。

5. 优化Intent启动参数 #

可以额外添加Activity启动标识，避免任务栈异常导致页面不展示：

Intent intent1 = new Intent(context, MainActivity.class);
intent1.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK 
    | Intent.FLAG_ACTIVITY_CLEAR_TOP 
    | Intent.FLAG_ACTIVITY_SINGLE_TOP);
context.startActivity(intent1);

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