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

消息队列发送逻辑应该怎么放

消息队列发送逻辑应该怎么放

领域事件表达“业务上发生了什么”,Kafka、RabbitMQ 则只是把消息送出去的技术手段。把两者混在一起,会让领域模型依赖客户端 API,也会把序列化、Topic 和重试策略侵入业务代码。

学习目标

  • 区分领域事件、事件发布端口与消息队列客户端的职责
  • 理解 Kafka、RabbitMQ 发送实现为什么属于基础设施层
  • 识别直接发消息与数据库事务之间的一致性风险

先分清领域事件、发布端口和 Broker

OrderPaid 这类领域事件应该使用业务语言描述已经发生的事实,不包含 Kafka ProducerRecord、RabbitMQ Message 或 Topic 配置。应用层决定何时把事件交给外部世界,并依赖发布端口;基础设施层实现这个端口,把事件转换为具体消息。

领域事件到消息队列的数据流

用发布端口隔离 Kafka 或 RabbitMQ

下面用一个桩 KafkaClient 表示基础设施客户端。应用服务只依赖 EventPublisher,领域事件本身完全不知道 Kafka。

java
public class EventPublishDemo {
    record OrderPaid(String orderId, long paidAmountFen) {}

    interface EventPublisher {
        void publish(Object event);
    }

    static class PaymentApplicationService {
        private final EventPublisher publisher;

        PaymentApplicationService(EventPublisher publisher) {
            this.publisher = publisher;
        }

        void confirmPaid(String orderId, long amountFen) {
            OrderPaid event = new OrderPaid(orderId, amountFen);
            publisher.publish(event);
        }
    }

    static class KafkaClient {
        void send(String topic, String payload) {
            System.out.println("topic=" + topic + ", payload=" + payload);
        }
    }

    static class KafkaEventPublisher implements EventPublisher {
        private final KafkaClient client = new KafkaClient();

        @Override
        public void publish(Object event) {
            if (event instanceof OrderPaid e) {
                String payload = "{\"orderId\":\"" + e.orderId()
                        + "\",\"paidAmountFen\":" + e.paidAmountFen() + "}";
                client.send("order-paid", payload);
                return;
            }
            throw new IllegalArgumentException("unsupported event: " + event.getClass());
        }
    }

    public static void main(String[] args) {
        PaymentApplicationService service =
                new PaymentApplicationService(new KafkaEventPublisher());
        service.confirmPaid("O2001", 12800);
    }
}

预期输出

text
topic=order-paid, payload={"orderId":"O2001","paidAmountFen":12800}

如果将来改用 RabbitMQ,只需要新增另一个 EventPublisher 实现并调整装配;OrderPaid 和应用服务不需要引入 RabbitMQ API。

把消息协议细节留在基础设施层

Topic 名称、Exchange、Routing Key、分区键、消息头、JSON 或 Avro 序列化以及客户端重试都属于消息基础设施细节。它们可以依据领域事件做映射,但不应该反向污染领域事件定义。

应用层负责“什么时候应该发布”,基础设施层负责“怎样把它送到 Broker”。这种边界也让单元测试可以替换成记录事件的内存发布器,而不需要启动真实消息队列。

不要忽略数据库事务与消息投递的一致性

最常见的问题不是代码放错层,而是数据库提交和 MQ 发送无法组成一个普通本地事务。如果数据库提交成功后进程崩溃,消息可能没有发送;如果先发消息再提交数据库,消费者又可能看到最终被回滚的数据。

对要求可靠投递的业务,常见做法是 Transactional Outbox:应用事务同时写业务数据和 Outbox 记录,再由基础设施任务读取未发送记录并投递到 Kafka 或 RabbitMQ。发送成功后更新投递状态,失败则按策略重试。

此时领域层仍然只负责产生业务事实,应用层负责事务和发布时机,Broker 客户端、序列化、重试以及 Outbox 投递器继续位于基础设施边界。这样消息中间件才是真正可替换的技术实现,而不是领域模型的一部分。

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

目录与阅读设置

阅读设置

17

记录一个想法

消息队列发送逻辑应该怎么放

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

登录哪都通