架构与系统设计 / 系统课时

定时补偿任务

定时补偿任务

本课实现一套可重复执行的交易补偿流程:扫描长时间处理中或通知缺失的订单,查询渠道真实状态,校正本地数据,重试商户通知,并对无法自动收敛的记录告警。

学习目标

  • 定义补偿任务的扫描范围与处理顺序
  • 编写可索引的超时订单查询条件
  • 设计查询、校正、通知与告警的幂等机制

补偿任务处理范围

补偿任务不应全表扫描。通常只处理两类记录:超过阈值仍为 PROCESSING 或 UNKNOWN 的交易,以及支付已成功但商户通知仍未成功的交易。失败终态、已撤销、已全额退款等记录应排除。

每条记录还应具备下一次执行时间、重试次数和锁定标记。任务只领取 next_retry_time <= 当前时间 的数据,处理后按退避策略更新下次时间,避免每分钟重复冲击渠道。

扫描与处理流程

单条订单的顺序应固定为“领取任务、查询渠道、校正订单、写操作日志、触发通知、决定是否告警”。查询和通知必须分开计数,因为渠道查询成功不代表商户通知成功。

定时补偿任务处理流程

并发节点之间应使用数据库抢占更新、悲观锁或分布式锁控制同一任务只能被一个实例执行。锁必须设置超时,实例崩溃后才能重新领取。

扫描条件与索引

下面 SQL 通过范围条件筛选到期任务,避免对时间列使用函数。建议建立联合索引 (task_status, next_retry_time, id)。

sql
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;

预期结果:

text
+----+----------------------+------------------+-------------+
| id | order_no             | task_type        | retry_count |
+----+----------------------+------------------+-------------+
| <ID> | <ORDER_NO>           | QUERY_PAYMENT    | 2           |
| <ID> | <ORDER_NO>           | RETRY_NOTIFY     | 1           |
+----+----------------------+------------------+-------------+

执行前将 <TIME> 替换为实际截止时间;结果中的 <ID> 与 <ORDER_NO> 取决于数据库中的到期记录。

可执行的补偿示例

下面使用 JDK 定时线程模拟一次补偿扫描。第一笔处理中订单被渠道确认为成功并触发通知,第二笔成功订单只补发通知,未超时订单被跳过。

java
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();
    }
}

预期输出:

text
P1001 CORRECT_TO_SUCCESS
P1001 RETRY_NOTIFY
P1002 RETRY_NOTIFY
P1003 SKIP_NOT_DUE

调度与告警边界

补偿任务应采用“小批量、短事务”。领取任务和更新领取状态可在一个事务中完成,渠道查询与通知属于外部调用,不要长时间占用数据库事务;外部调用结束后再开启短事务写回结果。

建议分别限制查询重试和通知重试次数。达到上限、连续返回未知、订单金额较大或状态发生非法跳转时,应进入人工告警队列,并携带订单号、渠道流水号、最近错误、重试次数和追踪号。

验证上线效果时至少观察:到期任务积压量、平均收敛时间、查询成功率、通知成功率、单任务重试次数和告警数量。指标下降后仍要保留审计日志,便于追查每次自动校正的依据。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

定时补偿任务

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通