架构与系统设计 / 系统课时
消息队列发送逻辑应该怎么放
消息队列发送逻辑应该怎么放
领域事件表达“业务上发生了什么”,Kafka、RabbitMQ 则只是把消息送出去的技术手段。把两者混在一起,会让领域模型依赖客户端 API,也会把序列化、Topic 和重试策略侵入业务代码。
学习目标
- 区分领域事件、事件发布端口与消息队列客户端的职责
- 理解 Kafka、RabbitMQ 发送实现为什么属于基础设施层
- 识别直接发消息与数据库事务之间的一致性风险
先分清领域事件、发布端口和 Broker
OrderPaid 这类领域事件应该使用业务语言描述已经发生的事实,不包含 Kafka ProducerRecord、RabbitMQ Message 或 Topic 配置。应用层决定何时把事件交给外部世界,并依赖发布端口;基础设施层实现这个端口,把事件转换为具体消息。

用发布端口隔离 Kafka 或 RabbitMQ
下面用一个桩 KafkaClient 表示基础设施客户端。应用服务只依赖 EventPublisher,领域事件本身完全不知道 Kafka。
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);
}
}预期输出
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 投递器继续位于基础设施边界。这样消息中间件才是真正可替换的技术实现,而不是领域模型的一部分。