WakefulBroadcastReceiver在Nougat/Oreo设备上获取Alarm为null问题排查

嘿，这个问题我之前做闹钟应用的时候也踩过坑，咱们来好好捋一捋：

在Android 7.0（API 24）及以上系统中，你的Alarm对象获取为null，主要是因为两个核心原因：

1. 高版本系统对Parcelable的校验更严格
   旧版Android对自定义Parcelable类的实现兼容性比较宽松，哪怕序列化/反序列化的字段顺序有小问题，也可能勉强解析成功。但从Nougat开始，系统会严格校验Parcelable的读写逻辑，只要字段顺序、类型不匹配，或者CREATOR实现有问题，就会直接返回null，不会像旧版本那样“容错”。

2. PendingIntent的创建或复用问题
   如果你的PendingIntent使用了FLAG_UPDATE_CURRENT，但创建时没有确保Intent里的Alarm对象是最新的，或者不同闹钟用了相同的requestCode导致PendingIntent被覆盖，就会导致接收器拿到的Extra是空的。另外Android O之后的后台限制虽然主要影响服务启动，但也可能间接导致Intent数据传递异常。

咱们一步步来修复：

1. 彻底检查并修复Alarm类的Parcelable实现 #

这是最常见的问题点，一定要保证writeToParcel和CREATOR的createFromParcel方法中，字段的读写顺序、类型完全一致，不能有任何遗漏或错位。

举个正确的实现示例：

public class Alarm implements Parcelable {
    private int alarmId;
    private long triggerTime;
    private boolean isSnooze;

    // 构造函数、getter/setter等

    @Override
    public void writeToParcel(Parcel dest, int flags) {
        // 按顺序写入所有字段
        dest.writeInt(alarmId);
        dest.writeLong(triggerTime);
        dest.writeByte((byte) (isSnooze ? 1 : 0));
    }

    public static final Parcelable.Creator<Alarm> CREATOR = new Parcelable.Creator<Alarm>() {
        @Override
        public Alarm createFromParcel(Parcel in) {
            Alarm alarm = new Alarm();
            // 必须和writeToParcel的顺序完全对应
            alarm.alarmId = in.readInt();
            alarm.triggerTime = in.readLong();
            alarm.isSnooze = in.readByte() != 0;
            return alarm;
        }

        @Override
        public Alarm[] newArray(int size) {
            return new Alarm[size];
        }
    };

    @Override
    public int describeContents() {
        return 0; // 没有特殊内容返回0即可
    }
}

你可以写个简单的测试代码，手动序列化再反序列化Alarm对象，验证是否能正常恢复数据，如果这里失败，那肯定是Parcelable的问题。

2. 修正PendingIntent的创建逻辑 #

创建用于AlarmManager的PendingIntent时，注意两个关键点：

• 用唯一的requestCode：比如用每个闹钟的ID作为requestCode，避免不同闹钟的PendingIntent被互相覆盖，导致Extra数据丢失。
• 正确设置FLAG：Android 12及以上建议使用FLAG_IMMUTABLE（如果不需要修改Intent内容的话），结合FLAG_UPDATE_CURRENT确保更新Intent时Extra能被正确替换。

示例代码：

// 创建触发接收器的Intent
Intent alarmIntent = new Intent(context, AlarmReceiver.class);
alarmIntent.putExtra(Constants.ARGS_ALARM, targetAlarm); // 确保放入正确的Alarm对象

// 用闹钟ID作为唯一的requestCode
int requestCode = targetAlarm.getAlarmId();

// 创建PendingIntent
PendingIntent pendingIntent = PendingIntent.getBroadcast(
        context,
        requestCode,
        alarmIntent,
        PendingIntent.FLAG_UPDATE_CURRENT | PendingIntent.FLAG_IMMUTABLE
);

// 设置精确闹钟（N及以上建议用setExact或setExactAndAllowWhileIdle）
AlarmManager alarmManager = (AlarmManager) context.getSystemService(Context.ALARM_SERVICE);
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
    alarmManager.setExactAndAllowWhileIdle(AlarmManager.RTC_WAKEUP, targetAlarm.getTriggerTime(), pendingIntent);
} else {
    alarmManager.setExact(AlarmManager.RTC_WAKEUP, targetAlarm.getTriggerTime(), pendingIntent);
}

3. 替换旧的AlarmManager设置方法 #

如果你之前用的是AlarmManager.set()方法，在Android N之后这个方法会被系统调整为不精确闹钟，不仅触发时间不准，还可能导致Intent数据传递异常。建议改用setExact()或setExactAndAllowWhileIdle()（针对Doze模式下的闹钟触发），确保Intent能被正确传递到接收器。

修复后，分别在API17、API24、API26及以上的设备上测试，确认AlarmReceiver中能正常获取到Alarm对象，贪睡和停止功能也能正常工作。

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