支付订单成功异步MQ权益发放设计和开发

目录

一、讲解为什么支付成功后权益发放要用异步MQ,以及整体架构链路设计

[1.1 什么是权益发放?](#1.1 什么是权益发放?)

[1.2 为什么不能在支付回调里直接发放权益](#1.2 为什么不能在支付回调里直接发放权益)

[1.3 整体架构链路](#1.3 整体架构链路)

[1.4 MQ方案选型说明](#1.4 MQ方案选型说明)

[1.5 注意](#1.5 注意)

[1.6 BenefitGrantMQConfig 配置实现(放在 common 模块)](#1.6 BenefitGrantMQConfig 配置实现(放在 common 模块))

[1.7 关键参数说明](#1.7 关键参数说明)

二、权益发放消息体BenefitGrantMessage数据结构设计

[2.1 为什么消息体设计至关重要](#2.1 为什么消息体设计至关重要)

[2.2 字段设计说明](#2.2 字段设计说明)

[2.3 消息体复用设计亮点](#2.3 消息体复用设计亮点)

三、单权益订单发放processSingleBenefit设计和开发

[3.1 什么是单权益订单(BENEFIT_ORDER)](#3.1 什么是单权益订单(BENEFIT_ORDER))

[3.2 processSingleBenefit 实现](#3.2 processSingleBenefit 实现)


一、讲解为什么支付成功后权益发放要用异步MQ,以及整体架构链路设计

1.1 什么是权益发放?

  • 核心定义:用户支付成功后,系统根据订单内容给用户开通对应的服务权限

  • 打个比方:就像你买了视频会员,支付成功后账号立即获得观看权限

1.2 为什么不能在支付回调里直接发放权益

  • 痛点分析

    • 微信支付回调要求5秒内响应,超时会触发重试

    • 权益发放涉及数据库写入、跨服务调用,耗时不可控

    • 如果权益发放失败,直接影响回调响应,会让微信误以为支付处理失败,引发重复回调

    • 同步发放导致回调接口承压,系统稳定性差

  • 核心思路

    • 回调接口只做两件事:更新订单状态 + 发 MQ 消息,快速返回 SUCCESS

    • 权益发放逻辑异步交给 account-service 消费处理,解耦两个服务

1.3 整体架构链路

1.4 MQ方案选型说明

方案 优点 缺点 适合场景
RabbitMQ(选用) 消息可靠、手动ACK、成熟稳定 需要额外部署 权益发放、支付通知
直接HTTP调用 简单直接 同步阻塞、强耦合、易失败 实时性要求极高场景
数据库轮询 无额外组件 性能差、延迟高 低频补偿场景

1.5 注意

  • product-service 负责发消息 ,account-service 负责消费消息,两者只通过 MQ 通信

  • TopicExchange 支持通配符路由,扩展性好

  • 本章场景使用精确路由键 benefit.grant.routing.key,未来可扩展为 benefit.# 覆盖多种权益消息

  • 该配置类放在 common 模块,product-service 和 account-service 都能使用

1.6 BenefitGrantMQConfig 配置实现(放在 common 模块)

java 复制代码
/**
 * 权益发放 MQ 配置(common 模块共享)
 * 同时提供全局 JSON 消息转换器,供 product-service 和 account-service 使用
 */
@Configuration
public class BenefitGrantMQConfig {

    // 权益发放交换机
    public static final String BENEFIT_GRANT_EXCHANGE = "benefit.grant.exchange";

    // 权益发放队列(account-service 消费)
    public static final String BENEFIT_GRANT_QUEUE = "benefit.grant.queue";

    // 权益发放路由 key
    public static final String BENEFIT_GRANT_ROUTING_KEY = "benefit.grant.routing.key";

    /**
     * 配置 JSON 消息转换器,替代默认的 Java 原生序列化
     * Spring AMQP 3.x 默认使用 Java 原生序列化,会校验反序列化白名单导致失败,
     * 改用 Jackson2JsonMessageConverter 以 JSON 方式序列化/反序列化消息
     */
    @Bean
    public MessageConverter messageConverter() {
        return new Jackson2JsonMessageConverter();
    }

    /**
     * 配置 RabbitTemplate,使用 JSON 消息转换器
     */
    @Bean
    public RabbitTemplate rabbitTemplate(ConnectionFactory connectionFactory) {
        RabbitTemplate rabbitTemplate = new RabbitTemplate(connectionFactory);
        rabbitTemplate.setMessageConverter(messageConverter());
        return rabbitTemplate;
    }

    @Bean
    public TopicExchange benefitGrantExchange() {
        return new TopicExchange(BENEFIT_GRANT_EXCHANGE, true, false);
    }

    @Bean
    public Queue benefitGrantQueue() {
        return new Queue(BENEFIT_GRANT_QUEUE, true, false, false);
    }

    @Bean
    public Binding benefitGrantBinding() {
        return BindingBuilder.bind(benefitGrantQueue())
                .to(benefitGrantExchange())
                .with(BENEFIT_GRANT_ROUTING_KEY);
    }
}

1.7 关键参数说明

  • durable=true:持久化,RabbitMQ 重启后 Exchange/Queue 不丢失

  • exclusive=false:非独占,允许多个消费者连接

  • autoDelete=false:不自动删除,队列长期存在

二、权益发放消息体BenefitGrantMessage数据结构设计

2.1 为什么消息体设计至关重要

  • MQ 消息是 product-service 和 account-service 之间的唯一通信载体

  • 消息体字段设计好了,消费者无需再次查询数据库,直接基于消息完成权益发放

  • 消息体要同时支持两种订单类型:单权益订单(1条权益)和套餐订单(多条权益)

  • BenefitGrantMessage 消息体设计

java 复制代码
@Data
@Builder
@NoArgsConstructor
@AllArgsConstructor
public class BenefitGrantMessage {

    private String outTradeNo;   // 订单编号(用于幂等判断)
    private Long accountId;       // 用户账号ID(权益发放给谁)
    private Long orderId;         // 订单ID(account_benefit表的 product_order_id)
    private String orderType;     // 订单类型:BENEFIT_ORDER / PACKAGE_ORDER
    private List<BenefitItem> benefitItems; // 权益列表

    @Data
    @Builder
    @NoArgsConstructor
    @AllArgsConstructor
    public static class BenefitItem {
        private Long benefitId;      // 权益ID
        private String benefitCode;  // 权益编码
        private Integer count;       // 发放次数
        private Integer validDays;   // 单次有效天数(null 默认 365 天)
    }
}

2.2 字段设计说明

字段 说明 设计原因
outTradeNo 订单编号 用于日志追踪和幂等校验
orderId 订单ID 写入 account_benefit 表的 product_order_id,供幂等查重
orderType 订单类型 消费者可据此判断是否多权益
benefitItems 权益列表 单权益=1条,套餐=N条,统一结构
validDays 有效天数 null 时消费者默认按 365 天计算

2.3 消息体复用设计亮点

  • 权益订单:benefitItems 只包含 1 条 BenefitItem

  • 套餐订单:benefitItems 包含套餐下所有权益 ,只发1 条 MQ 消息(避免多次发送)

  • 消费者逻辑统一:遍历 benefitItems 逐条发放,无需区分订单类型

三、单权益订单发放processSingleBenefit设计和开发

3.1 什么是单权益订单(BENEFIT_ORDER)

  • 用户直接购买某一项具体权益,例如:购买 10 次 AI 面试次数

  • 对应 OrderTypeEnum.BENEFIT_ORDER,订单中有明确的 benefitId

  • 发放逻辑:查出权益信息 → 构建 1 条 BenefitItem → 发 MQ

3.2 processSingleBenefit 实现

java 复制代码
private void processSingleBenefit(ProductOrderDO orderDO) {
    // 1. 根据 benefitId 查询权益基础信息(validDays 等)
    BenefitDO benefitDO = benefitMapper.selectById(orderDO.getBenefitId());
    if (benefitDO == null) {
        log.error("权益不存在,发放失败, benefitId:{}", orderDO.getBenefitId());
        return;
    }

    // 2. 构建单条 BenefitItem
    BenefitGrantMessage.BenefitItem item = BenefitGrantMessage.BenefitItem.builder()
            .benefitId(benefitDO.getId())
            .benefitCode(benefitDO.getBenefitCode())
            .count(orderDO.getPurchaseCount())      // 购买数量
            .validDays(benefitDO.getValidDays())    // 单次有效天数
            .build();

    // 3. 构建消息并发送
    BenefitGrantMessage message = BenefitGrantMessage.builder()
            .outTradeNo(orderDO.getOutTradeNo())
            .accountId(orderDO.getAccountId())
            .orderId(orderDO.getId())
            .orderType(orderDO.getOrderType())
            .benefitItems(List.of(item))
            .build();

    rabbitTemplate.convertAndSend(
            BenefitGrantMQConfig.BENEFIT_GRANT_EXCHANGE,
            BenefitGrantMQConfig.BENEFIT_GRANT_ROUTING_KEY,
            message
    );
    log.info("单权益发放消息已发送, outTradeNo:{}, benefitId:{}", orderDO.getOutTradeNo(), benefitDO.getId());
}
相关推荐
jaysee-sjc1 小时前
【黑马点评】Day02:优惠券秒杀与分布式锁
java·分布式·nginx·spring·node.js·tomcat·maven
谙弆悕博士1 小时前
多智能体架构详解:市场拍卖式架构(Market-based / 竞价协商)
开发语言·架构·去中心化·多智能体·智能体·拍卖架构
秋天的怀念_David2 小时前
算法一千零一夜 · 第三十五夜 · 恢复风暴
java·程序人生·算法
考虑考虑2 小时前
JDK27中的加密对象的 PEM 编码
java·后端·java ee
江屿风2 小时前
AI Agent架构全解析:从规划到记忆的智能跃迁
人工智能·笔记·架构·agent·c/s·mcp工作流
行者-全栈开发2 小时前
SpringBoot + GraalVM 原生编译实战:启动时间从8秒到0.5秒的极致优化
java·spring boot·后端
CoderYanger3 小时前
Java EE 进阶:10. MyBatis-Plus使用(第一弹)
java·spring boot·后端·sql·spring·java-ee·mybatis
飞奔的瓜牛3 小时前
呼叫中心系统架构详解:语音网关、软交换、CTI、路由、IVR 与座席工作台
系统架构·呼叫中心
一条Go3 小时前
状态页与 SLA:对外承诺是怎么算出来的
后端·架构·github
EatFan4 小时前
AI Agent 工程化元年:从单体智能到 Agent 集群的架构演进与落地路径
人工智能·架构·ai agent·autogen·crewai·agent集群·记忆工程