实现SensorEventListener的后台Service仅触发一次问题排查

核心原因 #

你的问题本质是旧API适配新Android系统后台限制，结合SensorEventListener注册逻辑可能存在的问题：

1. Android 12+对后台传感器数据获取有严格限制，目标API19的旧应用会被强制执行新规则，后台Service若无前台优先级，无法持续获取传感器事件；
2. 重复注册/未正确注销SensorEventListener，导致Listener失效或被系统标记为无效；
3. AlarmManager的旧重复唤醒策略在新系统中被节流，Service无法获得足够优先级触发传感器监听。

具体解决步骤 #

1. 修复SensorEventListener注册/注销逻辑 #

确保Listener仅在Service创建时初始化，启动时注册、销毁时注销，避免重复注册或内存泄漏：

private SensorManager sensorManager;
private Sensor accelerometer;
private SensorEventListener sensorListener;

@Override
public void onCreate() {
    super.onCreate();
    sensorManager = (SensorManager) getSystemService(SENSOR_SERVICE);
    accelerometer = sensorManager.getDefaultSensor(Sensor.TYPE_ACCELEROMETER);
    
    // 全局初始化Listener，避免每次启动新建实例
    sensorListener = new SensorEventListener() {
        @Override
        public void onSensorChanged(SensorEvent event) {
            // 处理加速度数据逻辑
            Log.d(TAG, "Accelerometer data: x=" + event.values[0] + ", y=" + event.values[1] + ", z=" + event.values[2]);
        }

        @Override
        public void onAccuracyChanged(Sensor sensor, int accuracy) {}
    };
}

@Override
public int onStartCommand(Intent intent, int flags, int startId) {
    // 仅当传感器存在且未注册时执行注册
    if (accelerometer != null) {
        boolean isRegistered = sensorManager.registerListener(sensorListener, accelerometer, SensorManager.SENSOR_DELAY_NORMAL);
        Log.d(TAG, "Sensor listener registered status: " + isRegistered);
    }

    // 采集完成后主动停止Service，减少后台占用
    new Handler(Looper.getMainLooper()).postDelayed(() -> stopSelf(), 5000);

    return START_STICKY;
}

@Override
public void onDestroy() {
    super.onDestroy();
    // 强制注销Listener，避免泄漏
    if (sensorManager != null && sensorListener != null) {
        sensorManager.unregisterListener(sensorListener);
        Log.d(TAG, "Sensor listener unregistered");
    }
}

2. 适配新系统后台传感器权限与前台服务 #

Android 12+要求后台获取传感器需ACCESS_BACKGROUND_SENSOR权限，同时Service需转为前台服务：

• 在AndroidManifest.xml添加权限：

<uses-permission android:name="android.permission.ACCESS_BACKGROUND_SENSOR" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<uses-permission android:name="android.permission.POST_NOTIFICATIONS" /> <!-- Android 13+ 必填 -->

• 在Service中添加前台通知逻辑：

private static final int FOREGROUND_NOTIFY_ID = 1001;

private void startForegroundIfNeeded() {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
        NotificationChannel channel = new NotificationChannel("sensor_collect_channel", "传感器采集", NotificationManager.IMPORTANCE_LOW);
        NotificationManager nm = (NotificationManager) getSystemService(NOTIFICATION_SERVICE);
        nm.createNotificationChannel(channel);
    }

    Notification notify = new NotificationCompat.Builder(this, "sensor_collect_channel")
            .setContentTitle("加速度数据采集")
            .setContentText("后台运行中")
            .setSmallIcon(R.drawable.ic_app_icon)
            .setPriority(NotificationCompat.PRIORITY_LOW)
            .build();

    startForeground(FOREGROUND_NOTIFY_ID, notify);
}

在onStartCommand()开头调用startForegroundIfNeeded()。

3. 调整AlarmManager唤醒策略 #

API19后setRepeating()会被系统节流，改用setExactAndAllowWhileIdle()实现精确重复唤醒：

// 初始化Alarm的代码（如在Activity/BootCompletedReceiver中）
private void setupRepeatingAlarm() {
    AlarmManager am = (AlarmManager) getSystemService(ALARM_SERVICE);
    Intent intent = new Intent(this, YourSensorService.class);
    PendingIntent pi = PendingIntent.getService(this, 0, intent, 
            PendingIntent.FLAG_UPDATE_CURRENT | PendingIntent.FLAG_IMMUTABLE);

    long interval = 60 * 1000; // 1分钟间隔
    long nextTrigger = System.currentTimeMillis() + interval;

    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
        am.setExactAndAllowWhileIdle(AlarmManager.RTC_WAKEUP, nextTrigger, pi);
    } else if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
        am.setExact(AlarmManager.RTC_WAKEUP, nextTrigger, pi);
    } else {
        am.setRepeating(AlarmManager.RTC_WAKEUP, nextTrigger, interval, pi);
    }
}

// 在Service的onStartCommand()末尾重新设置下一次Alarm
@Override
public int onStartCommand(Intent intent, int flags, int startId) {
    // ... 其他逻辑 ...

    // 重新调度下一次Alarm
    setupRepeatingAlarm();
    return START_STICKY;
}

4. 验证注册状态 #

通过日志确认传感器注册是否成功，若注册失败，检查：

• 权限是否已授予（尤其是ACCESS_BACKGROUND_SENSOR）；
• Listener实例是否被正确持有。

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