发生了什么

手机可以把正在进行的任务做成一张常驻卡片,钉在锁屏和屏幕顶部的小区域(灵动岛)上,这类卡片在系统里叫“实时活动”。电池开始充电后,配套的 App 会创建一条推送任务,同时开一条实时活动。推送任务记录这次充电要推送的内容,是这次推送的凭据;实时活动就是用户看到的那张卡片,上面显示“充电中”。充电过程中,服务端还会安排延迟检查消息,在稍后的时间点检查一次并推送更新。

正常流程是:电池开始充电,创建推送任务和实时活动;延迟检查消息到点执行,把这次充电的更新推送出去;用户停止充电,系统清除推送任务、关闭实时活动,卡片消失,此后不应再出现属于这次充电的推送。

这一次,用户在静默期(系统不主动打扰用户的一段时间)之外开始充电,系统按流程创建了推送任务和实时活动。随后用户进入静默期,系统关闭了实时活动;再之后,用户停止了充电。问题出在关闭之后:此前已经排好的延迟检查消息没有跟着作废,到点仍然执行并推送,卡片上又出现了“充电中”。用户反馈电池实际并没有在充电,看到的却是充电中的状态。影响限于展示:卡片显示的状态与电池实际状态不一致。

本质

一次充电对应两个对象。推送任务记录这次推送的归属和内容,是判断“还要不要推”的依据;实时活动是展示载体,挂在推送任务下面。延迟检查消息是为某条推送任务安排的异步消息,到点后由消息处理程序取出执行。

清除推送任务和关闭实时活动,处理的是任务记录和当前这条活动本身,没有处理已经发出、还在等待到点的延迟消息。消息处理程序执行时,也没有回头确认所属的推送任务是否仍然有效。为了兼容新老版本中仍在进行的实时活动,这条路径在任务已经清除的情况下没有停下,消息到点后继续推送。于是,一条属于已经结束的充电的旧消息,在用户停止充电之后仍然被推了出去,卡片上再次出现充电中。

可以用两句话概括:任务清除只代表以后不再产生新的推送,不代表已经排队的消息会消失;展示卡片关闭也不代表服务端到点执行的延迟消息会停止。修复方向是让消息的生命周期跟着任务走:清除推送任务时,一并作废该任务下已经排队的延迟检查消息;消息处理程序执行前先按任务标识查一次,任务不存在或已清除就直接丢弃。记录里给出的处理是“推送任务清除后,直接丢弃延迟检查推送消息”,是否已经上线并验证,记录没有说明。

错误代码

/** 清除本次充电的推送任务,并关闭对应实时活动 */
public void clearPushTask(Long taskId) {
    pushTaskMapper.deleteById(taskId);   // 为什么错:只删任务记录,
    liveActivityService.close(taskId);   // 已排队的延迟消息仍在等待到点,没有一起作废
}

/** 延迟检查消息到点后的处理 */
public void onDelayedCheck(DelayedCheckMessage msg) {
    LiveActivity activity = liveActivityMapper.selectById(msg.getActivityId());
    if (activity == null) {
        return;
    }
    // 为什么错:不校验消息所属的推送任务是否已清除;为了兼容新老版本
    // 仍在进行的活动,即使充电已经结束,也照常把这次充电的更新推出去
    pushService.push(activity.getPushToken(), msg.getPayload());
}

修复代码示例

/** 清除推送任务时,同时作废它名下已排队的延迟消息 */
public void clearPushTask(Long taskId) {
    pushTaskMapper.markCleared(taskId);                      // 先标记,消费端据此判断
    delayedMessageService.invalidateByTask(taskId);          // 再作废尚未到点的延迟消息
    liveActivityService.close(taskId);
}

/** 延迟检查消息到点后的处理 */
public void onDelayedCheck(DelayedCheckMessage msg) {
    PushTask task = pushTaskMapper.selectById(msg.getTaskId());
    if (task == null || task.isCleared()) {
        log.info("discard delayed check, task cleared, taskId={}", msg.getTaskId());
        return;                                 // 任务已清除,迟到的检查消息直接丢弃
    }
    LiveActivity activity = liveActivityMapper.selectById(task.getActivityId());
    if (activity == null || !activity.isShowing()) {
        return;
    }
    pushService.push(activity.getPushToken(), msg.getPayload());
}

两段代码是脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现。

下次遇到这些场景要警惕

  • 关闭一个带延迟消息或定时任务的对象:先列出这条链路上所有已排队的消息,再执行“创建 → 清除或关闭 → 等到原定时间点”的完整流程,确认关闭之后不再有任何推送发出。
  • 在消息消费端增加兼容新旧版本的分支:写清老版本对象缺少哪些字段、新代码依赖哪些字段,再分别用新老版本创建的对象走一遍关闭流程;兼容分支不能绕过“所属任务是否仍然有效”的判断。
  • 收到“展示状态和实际状态不一致”的反馈:按“最后一条更新在什么时间、由哪条延迟消息发出”去查推送记录,而不是只看卡片有没有关闭;确认清除动作是否真的让旧消息失效。
  • 用删除记录来解决“以后不再推送”:验证删除后已排队的消息不会继续执行,否则旧消息会在清除之后照常产生结果。