架构与系统设计 / 系统课时
退款状态处理
退款状态处理
本课建立退款状态机,把渠道通知、主动查询和调用异常统一转换为可控的状态流转,并通过终态保护与幂等处理,避免重复回调、乱序消息或查询超时覆盖已经确认的退款结果。
学习目标
- 定义退款处理中、成功、失败和结果未知的边界
- 实现可验证的合法状态迁移规则
- 处理重复通知、乱序事件和并发更新
状态模型
PROCESSING 表示渠道已受理但结果未确认;SUCCESS 和 FAILED 是最终状态;UNKNOWN 表示平台无法判断渠道是否处理成功,需要继续查询。网络超时只能产生 UNKNOWN,不能证明退款失败。
退款单首次提交并明确受理后进入 PROCESSING。后续通知或查询可将 PROCESSING、UNKNOWN 收敛到终态;终态一旦确认,不再被处理中或未知结果回退。

可运行的状态机示例
下面的 Java 17 示例把状态和事件分离。重复成功通知会被终态保护直接忽略;UNKNOWN 收到“仍在处理”的查询结果后可以回到 PROCESSING,继续等待最终结果。
public class RefundStateMachineDemo {
enum RefundStatus {
PROCESSING, SUCCESS, FAILED, UNKNOWN
}
enum RefundEvent {
CHANNEL_SUCCESS,
CHANNEL_FAILED,
QUERY_PROCESSING,
QUERY_UNKNOWN
}
static final class RefundStateMachine {
private RefundStatus status = RefundStatus.PROCESSING;
RefundStatus current() {
return status;
}
RefundStatus apply(RefundEvent event) {
// 成功和失败是终态,重复或乱序事件不得覆盖最终结果。
if (status == RefundStatus.SUCCESS
|| status == RefundStatus.FAILED) {
return status;
}
status = switch (status) {
case PROCESSING -> switch (event) {
case CHANNEL_SUCCESS -> RefundStatus.SUCCESS;
case CHANNEL_FAILED -> RefundStatus.FAILED;
case QUERY_PROCESSING -> RefundStatus.PROCESSING;
case QUERY_UNKNOWN -> RefundStatus.UNKNOWN;
};
case UNKNOWN -> switch (event) {
case CHANNEL_SUCCESS -> RefundStatus.SUCCESS;
case CHANNEL_FAILED -> RefundStatus.FAILED;
case QUERY_PROCESSING -> RefundStatus.PROCESSING;
case QUERY_UNKNOWN -> RefundStatus.UNKNOWN;
};
case SUCCESS, FAILED -> status;
};
return status;
}
}
public static void main(String[] args) {
RefundStateMachine machine = new RefundStateMachine();
System.out.println(machine.current());
System.out.println(machine.apply(
RefundEvent.QUERY_UNKNOWN));
System.out.println(machine.apply(
RefundEvent.CHANNEL_SUCCESS));
System.out.println(machine.apply(
RefundEvent.CHANNEL_SUCCESS));
System.out.println(machine.apply(
RefundEvent.QUERY_PROCESSING));
}
}预期输出:
PROCESSING
UNKNOWN
SUCCESS
SUCCESS
SUCCESS最后一次查询返回“处理中”,但退款单已经成功,因此状态仍保持 SUCCESS。
事件处理顺序
收到异步通知时,先按渠道事件唯一标识或“渠道退款号 + 状态”做去重,再校验签名和退款金额,最后执行状态迁移。主动查询与异步通知可能并发到达,业务代码不能依赖固定先后顺序。
数据库更新应带原状态或版本条件,例如只允许从 PROCESSING、UNKNOWN 更新为终态。若受影响行数为 0,应重新读取当前状态;如果已经是相同终态,则按幂等成功处理,如果是冲突终态,则记录告警并进入人工核查。
未知状态的补偿策略
UNKNOWN 需要进入定时查询队列,并使用原退款单号或渠道退款号查询。查询间隔应逐步放大,避免短时间高频请求;达到最大查询次数后仍未知时,保留现场数据并转人工处理,不能自动重发一笔新退款。
只有渠道明确返回最终失败,或查询接口明确确认退款不存在且可安全重试时,才允许转为 FAILED。调用超时、HTTP 5xx、报文解析失败和临时限流都不满足这一条件。
验收检查
验证时至少构造四类序列:正常成功、明确失败、先未知后成功、成功后收到旧的处理中事件。每条序列都应检查最终状态、状态变更次数和业务副作用次数。
状态更新成功后再触发退款成功通知、账务冲正或可退金额回补,并通过事务消息或事件表保证可靠投递。重复事件不得重复记账,也不得重复通知下游。