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

退款状态处理

退款状态处理

本课建立退款状态机,把渠道通知、主动查询和调用异常统一转换为可控的状态流转,并通过终态保护与幂等处理,避免重复回调、乱序消息或查询超时覆盖已经确认的退款结果。

学习目标

  • 定义退款处理中、成功、失败和结果未知的边界
  • 实现可验证的合法状态迁移规则
  • 处理重复通知、乱序事件和并发更新

状态模型

PROCESSING 表示渠道已受理但结果未确认;SUCCESS 和 FAILED 是最终状态;UNKNOWN 表示平台无法判断渠道是否处理成功,需要继续查询。网络超时只能产生 UNKNOWN,不能证明退款失败。

退款单首次提交并明确受理后进入 PROCESSING。后续通知或查询可将 PROCESSING、UNKNOWN 收敛到终态;终态一旦确认,不再被处理中或未知结果回退。

退款状态迁移图

可运行的状态机示例

下面的 Java 17 示例把状态和事件分离。重复成功通知会被终态保护直接忽略;UNKNOWN 收到“仍在处理”的查询结果后可以回到 PROCESSING,继续等待最终结果。

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

预期输出:

text
PROCESSING
UNKNOWN
SUCCESS
SUCCESS
SUCCESS

最后一次查询返回“处理中”,但退款单已经成功,因此状态仍保持 SUCCESS。

事件处理顺序

收到异步通知时,先按渠道事件唯一标识或“渠道退款号 + 状态”做去重,再校验签名和退款金额,最后执行状态迁移。主动查询与异步通知可能并发到达,业务代码不能依赖固定先后顺序。

数据库更新应带原状态或版本条件,例如只允许从 PROCESSING、UNKNOWN 更新为终态。若受影响行数为 0,应重新读取当前状态;如果已经是相同终态,则按幂等成功处理,如果是冲突终态,则记录告警并进入人工核查。

未知状态的补偿策略

UNKNOWN 需要进入定时查询队列,并使用原退款单号或渠道退款号查询。查询间隔应逐步放大,避免短时间高频请求;达到最大查询次数后仍未知时,保留现场数据并转人工处理,不能自动重发一笔新退款。

只有渠道明确返回最终失败,或查询接口明确确认退款不存在且可安全重试时,才允许转为 FAILED。调用超时、HTTP 5xx、报文解析失败和临时限流都不满足这一条件。

验收检查

验证时至少构造四类序列:正常成功、明确失败、先未知后成功、成功后收到旧的处理中事件。每条序列都应检查最终状态、状态变更次数和业务副作用次数。

状态更新成功后再触发退款成功通知、账务冲正或可退金额回补,并通过事务消息或事件表保证可靠投递。重复事件不得重复记账,也不得重复通知下游。

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

目录与阅读设置

阅读设置

17

记录一个想法

退款状态处理

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

登录哪都通