Android解锁屏幕启动Activity报错：Background execution not allowed解决方案咨询

为什么会出现「Background execution not allowed」错误？ #

从Android 8.0（API 26）开始，系统引入了后台执行限制，禁止静态注册的BroadcastReceiver接收大部分隐式系统广播，ACTION_USER_PRESENT（屏幕解锁事件）属于被限制的范畴。你用静态注册的ScreenUnlockReceiver会被系统直接拦截，因此触发该错误。

是否能在解锁屏幕时直接启动前台Activity？ #

分两种情况：

1. App处于前台时：通过动态注册BroadcastReceiver监听ACTION_USER_PRESENT，此时可以在onReceive中启动Activity（需添加FLAG_ACTIVITY_NEW_TASK标记）。但如果App处于后台，Android 10+还会额外限制后台启动Activity的行为，只有满足特定条件（如App最近被用户交互过、有可见窗口等）才能成功启动。
2. App处于后台时：无法直接通过静态注册广播启动Activity，必须借助其他符合系统规则的方式。

可行的替代方案 #

1. 动态注册广播（仅App前台有效） #

在Activity的onResume中注册广播，onPause中注销，确保只有App在前台时监听解锁事件。示例代码：

private BroadcastReceiver unlockReceiver = new BroadcastReceiver() {
    @Override
    public void onReceive(Context context, Intent intent) {
        if (Intent.ACTION_USER_PRESENT.equals(intent.getAction())) {
            Intent targetIntent = new Intent(context, YourImageActivity.class);
            // 添加必要的启动标记
            targetIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_CLEAR_TOP);
            context.startActivity(targetIntent);
        }
    }
};

@Override
protected void onResume() {
    super.onResume();
    IntentFilter filter = new IntentFilter(Intent.ACTION_USER_PRESENT);
    registerReceiver(unlockReceiver, filter);
}

@Override
protected void onPause() {
    super.onPause();
    unregisterReceiver(unlockReceiver);
}

2. 前台服务（持续监听，需显示通知） #

如果需要App在后台也能监听解锁事件，可以启动一个前台服务（必须显示通知），在服务内部动态注册广播。这种方式不受后台广播限制，且能持续监听。

步骤1：创建前台服务

public class UnlockMonitorService extends Service {
    private BroadcastReceiver unlockReceiver;

    @Override
    public void onCreate() {
        super.onCreate();
        // 注册解锁广播
        unlockReceiver = new BroadcastReceiver() {
            @Override
            public void onReceive(Context context, Intent intent) {
                if (Intent.ACTION_USER_PRESENT.equals(intent.getAction())) {
                    Intent targetIntent = new Intent(context, YourImageActivity.class);
                    targetIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
                    startActivity(targetIntent);
                }
            }
        };
        IntentFilter filter = new IntentFilter(Intent.ACTION_USER_PRESENT);
        registerReceiver(unlockReceiver, filter);

        // 启动前台服务（Android 8.0+ 必须）
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
            NotificationChannel channel = new NotificationChannel("unlock_channel", "解锁监听", NotificationManager.IMPORTANCE_LOW);
            NotificationManager manager = getSystemService(NotificationManager.class);
            manager.createNotificationChannel(channel);

            Notification notification = new Notification.Builder(this, "unlock_channel")
                    .setContentTitle("正在监听解锁")
                    .setSmallIcon(R.drawable.ic_notification)
                    .build();
            startForeground(1, notification);
        }
    }

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

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

步骤2：声明权限与服务

在AndroidManifest.xml中添加：

<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<uses-permission android:name="android.permission.POST_NOTIFICATIONS" /> <!-- Android 13+ 需要 -->

<service android:name=".UnlockMonitorService" />

步骤3：启动服务

在App启动时（如主Activity的onCreate）启动服务：

Intent serviceIntent = new Intent(this, UnlockMonitorService.class);
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
    startForegroundService(serviceIntent);
} else {
    startService(serviceIntent);
}

3. AccessibilityService（高权限，需用户授权） #

如果你的App属于无障碍工具类，可以使用AccessibilityService监听屏幕解锁事件。这种方式无需前台服务，且不受后台限制，但需要用户手动开启辅助功能权限。

示例核心代码：

public class UnlockAccessibilityService extends AccessibilityService {
    @Override
    public void onAccessibilityEvent(AccessibilityEvent event) {
        // 监听窗口状态变化，判断是否解锁
        if (event.getEventType() == AccessibilityEvent.TYPE_WINDOW_STATE_CHANGED) {
            AccessibilityWindowInfo windowInfo = event.getSource().getWindowInfo();
            if (windowInfo != null && windowInfo.getType() == AccessibilityWindowInfo.TYPE_APPLICATION) {
                // 此处可判断是否为解锁后的界面，启动目标Activity
                Intent targetIntent = new Intent(this, YourImageActivity.class);
                targetIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
                startActivity(targetIntent);
            }
        }
    }

    @Override
    public void onInterrupt() {}
}

在Manifest中声明服务：

<service android:name=".UnlockAccessibilityService"
         android:permission="android.permission.BIND_ACCESSIBILITY_SERVICE">
    <intent-filter>
        <action android:name="android.accessibilityservice.AccessibilityService" />
    </intent-filter>
    <meta-data android:name="android.accessibilityservice"
               android:resource="@xml/accessibility_config" />
</service>

创建res/xml/accessibility_config.xml：

<accessibility-service xmlns:android="http://schemas.android.com/apk/res/android"
    android:accessibilityEventTypes="typeWindowStateChanged"
    android:accessibilityFeedbackType="feedbackGeneric"
    android:accessibilityFlags="flagDefault"
    android:canRetrieveWindowContent="true" />

4. 用户主动触发（最合规） #

如果业务允许，引导用户在解锁后手动触发功能，比如：

• 在桌面添加App快捷方式，直接打开显示图片的Activity
• 用App Widget触发目标功能
  这种方式完全符合系统规则，无权限和后台限制问题。

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