Android地理围栏后台/被杀状态下通知不触发问题求助

核心问题分析 #

Android 12（API 31）及以上系统对后台BroadcastReceiver的唤醒做了严格限制，应用被杀后静态注册的广播接收器无法被系统唤醒触发Geofence事件；同时系统的Doze模式、电池优化策略也会抑制Geofence的后台触发逻辑。

具体修复步骤 #

1. 替换BroadcastReceiver为JobIntentService #

系统优先唤醒Service处理后台事件，JobIntentService适配Android O+的后台限制，能在应用被杀后被系统调度唤醒。

创建GeofenceIntentService：

public class GeofenceIntentService extends JobIntentService {
    private static final String TAG = "GeofenceIntentService";
    public static final int JOB_ID = 1001;

    public static void enqueueWork(Context context, Intent intent) {
        enqueueWork(context, GeofenceIntentService.class, JOB_ID, intent);
    }

    @Override
    protected void onHandleWork(@NonNull Intent intent) {
        handleGeofenceEvent(intent);
    }

    private void handleGeofenceEvent(Intent intent) {
        GeofencingEvent geofencingEvent = GeofencingEvent.fromIntent(intent);
        if (geofencingEvent.hasError()) {
            Log.e(TAG, "Geofence error code: " + geofencingEvent.getErrorCode());
            return;
        }

        int transitionType = geofencingEvent.getGeofenceTransition();
        NotificationHelper notificationHelper = new NotificationHelper(this);

        switch (transitionType) {
            case Geofence.GEOFENCE_TRANSITION_ENTER:
                notificationHelper.sendHighPriorityNotification("进入地理围栏", "", MapsActivity.class);
                break;
            case Geofence.GEOFENCE_TRANSITION_EXIT:
                notificationHelper.sendHighPriorityNotification("离开地理围栏", "", MapsActivity.class);
                break;
            case Geofence.GEOFENCE_TRANSITION_DWELL:
                notificationHelper.sendHighPriorityNotification("停留地理围栏", "", MapsActivity.class);
                break;
        }
    }
}

2. 更新GeofenceHelper的PendingIntent配置 #

将原广播类型的PendingIntent替换为前台服务类型，适配Android 12+的权限要求：

public PendingIntent getPendingIntent() {
    if (pendingIntent != null) {
        return pendingIntent;
    }
    Intent intent = new Intent(this, GeofenceIntentService.class);
    // Android 12+必须设置FLAG_MUTABLE，同时使用getForegroundService确保权限合规
    pendingIntent = PendingIntent.getForegroundService(this, 2607, intent, 
        PendingIntent.FLAG_UPDATE_CURRENT | PendingIntent.FLAG_MUTABLE);
    return pendingIntent;
}

3. 配置Manifest权限与Service声明 #

在AndroidManifest.xml中添加必要配置：

<!-- 前台服务权限 -->
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE_LOCATION" />

<!-- 注册JobIntentService -->
<service
    android:name=".GeofenceIntentService"
    android:permission="android.permission.BIND_JOB_SERVICE" />

4. 排除应用电池优化 #

系统电池优化会阻止Geofence后台触发，需引导用户将应用加入白名单：

private void requestIgnoreBatteryOptimizations() {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
        PowerManager powerManager = (PowerManager) getSystemService(POWER_SERVICE);
        if (!powerManager.isIgnoringBatteryOptimizations(getPackageName())) {
            Intent intent = new Intent(Settings.ACTION_REQUEST_IGNORE_BATTERY_OPTIMIZATIONS);
            intent.setData(Uri.parse("package:" + getPackageName()));
            startActivity(intent);
        }
    }
}

在用户授予后台位置权限后调用此方法，引导完成操作。

5. 持久化Geofence注册 #

应用被杀后已注册的Geofence会失效，需在应用启动时重新注册。可在MapsActivity的onResume中检查并重新添加，或监听BOOT_COMPLETED广播，配合WorkManager在设备重启后自动恢复Geofence。

6. 适配国产ROM后台管控 #

小米、华为等国产ROM有额外后台限制，需引导用户开启：

• 应用自启动权限
• 后台运行权限
• 无限制后台耗电权限

关键注意事项 #

• Android 12+必须使用PendingIntent.FLAG_MUTABLE，否则会抛出权限异常
• 确保ACCESS_FINE_LOCATION和ACCESS_BACKGROUND_LOCATION权限均已授予
• 测试时需避免使用模拟器，部分模拟器对Geofence的后台触发支持不完善

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