架构与系统设计 / 系统课时
定时补偿任务
定时补偿任务
本课实现一套可重复执行的交易补偿流程:扫描长时间处理中或通知缺失的订单,查询渠道真实状态,校正本地数据,重试商户通知,并对无法自动收敛的记录告警。
学习目标
- 定义补偿任务的扫描范围与处理顺序
- 编写可索引的超时订单查询条件
- 设计查询、校正、通知与告警的幂等机制
补偿任务处理范围
补偿任务不应全表扫描。通常只处理两类记录:超过阈值仍为 PROCESSING 或 UNKNOWN 的交易,以及支付已成功但商户通知仍未成功的交易。失败终态、已撤销、已全额退款等记录应排除。
每条记录还应具备下一次执行时间、重试次数和锁定标记。任务只领取 next_retry_time <= 当前时间 的数据,处理后按退避策略更新下次时间,避免每分钟重复冲击渠道。
扫描与处理流程
单条订单的顺序应固定为“领取任务、查询渠道、校正订单、写操作日志、触发通知、决定是否告警”。查询和通知必须分开计数,因为渠道查询成功不代表商户通知成功。

并发节点之间应使用数据库抢占更新、悲观锁或分布式锁控制同一任务只能被一个实例执行。锁必须设置超时,实例崩溃后才能重新领取。
扫描条件与索引
下面 SQL 通过范围条件筛选到期任务,避免对时间列使用函数。建议建立联合索引 (task_status, next_retry_time, id)。
SELECT id, order_no, task_type, retry_count
FROM payment_compensation_task
WHERE task_status = 'PENDING'
AND next_retry_time <= '<TIME>'
ORDER BY next_retry_time, id
LIMIT 100;预期结果:
+----+----------------------+------------------+-------------+
| id | order_no | task_type | retry_count |
+----+----------------------+------------------+-------------+
| <ID> | <ORDER_NO> | QUERY_PAYMENT | 2 |
| <ID> | <ORDER_NO> | RETRY_NOTIFY | 1 |
+----+----------------------+------------------+-------------+执行前将 <TIME> 替换为实际截止时间;结果中的 <ID> 与 <ORDER_NO> 取决于数据库中的到期记录。
可执行的补偿示例
下面使用 JDK 定时线程模拟一次补偿扫描。第一笔处理中订单被渠道确认为成功并触发通知,第二笔成功订单只补发通知,未超时订单被跳过。
import java.util.List;
import java.util.concurrent.CountDownLatch;
import java.util.concurrent.Executors;
import java.util.concurrent.ScheduledExecutorService;
import java.util.concurrent.TimeUnit;
public class CompensationJobDemo {
record Task(String orderNo, String localStatus,
String channelStatus, boolean notifyMissing,
int ageMinutes) {}
public static void main(String[] args) throws InterruptedException {
List<Task> tasks = List.of(
new Task("P1001", "PROCESSING", "SUCCESS", true, 25),
new Task("P1002", "SUCCESS", "SUCCESS", true, 40),
new Task("P1003", "PROCESSING", "PROCESSING", false, 5)
);
ScheduledExecutorService scheduler =
Executors.newSingleThreadScheduledExecutor();
CountDownLatch done = new CountDownLatch(1);
scheduler.schedule(() -> {
for (Task task : tasks) {
if (task.ageMinutes() < 15) {
System.out.println(task.orderNo() + " SKIP_NOT_DUE");
continue;
}
if ("PROCESSING".equals(task.localStatus())
&& "SUCCESS".equals(task.channelStatus())) {
System.out.println(task.orderNo() + " CORRECT_TO_SUCCESS");
}
if (task.notifyMissing()) {
System.out.println(task.orderNo() + " RETRY_NOTIFY");
}
}
done.countDown();
}, 0, TimeUnit.SECONDS);
done.await();
scheduler.shutdown();
}
}预期输出:
P1001 CORRECT_TO_SUCCESS
P1001 RETRY_NOTIFY
P1002 RETRY_NOTIFY
P1003 SKIP_NOT_DUE调度与告警边界
补偿任务应采用“小批量、短事务”。领取任务和更新领取状态可在一个事务中完成,渠道查询与通知属于外部调用,不要长时间占用数据库事务;外部调用结束后再开启短事务写回结果。
建议分别限制查询重试和通知重试次数。达到上限、连续返回未知、订单金额较大或状态发生非法跳转时,应进入人工告警队列,并携带订单号、渠道流水号、最近错误、重试次数和追踪号。
验证上线效果时至少观察:到期任务积压量、平均收敛时间、查询成功率、通知成功率、单任务重试次数和告警数量。指标下降后仍要保留审计日志,便于追查每次自动校正的依据。