架构与系统设计 / 系统课时
HTTP、MQ 和 RPC 入口怎样共存
HTTP、MQ 和 RPC 入口怎样共存
HTTP、MQ 和 RPC 的传输方式、错误模型和请求格式都不同,但它们不应该各自复制一套业务流程。更稳妥的做法是把它们视为不同的接口适配器,统一转换成应用层命令并调用同一个用例。
学习目标
- 理解多种外部协议如何映射到统一应用层
- 区分协议适配逻辑与业务用例逻辑
- 能设计避免 HTTP、MQ、RPC 重复业务代码的入口结构
不同协议只解决接入问题
HTTP 关注 URL、状态码和请求体,MQ 关注消息主题、确认与重试,RPC 关注方法调用和序列化契约。它们的差异是真实存在的,但这些差异主要位于系统边缘。
如果三个入口都在内部重复“校验订单、扣减额度、创建订单、保存结果”,同一用例就会出现三份实现。后续业务规则变化时,很容易只改其中一份,最终让不同入口产生不同结果。

统一到应用命令而不是统一协议
应用层不需要知道请求来自 HTTP、Kafka 还是 RPC。它只需要接收能够表达用例意图的命令,例如 SubmitOrderCommand。每个接口适配器负责从自己的协议对象构造该命令,再把应用层结果转换回对应协议。
下面的完整 Java 示例让三个入口调用同一个 SubmitOrderUseCase。为了突出边界,示例只保留最小业务规则。
public class Main {
record SubmitOrderCommand(String orderId, int quantity) {}
static final class SubmitOrderUseCase {
String handle(SubmitOrderCommand command) {
if (command.quantity() <= 0) {
throw new IllegalArgumentException("quantity must be positive");
}
return "accepted:" + command.orderId();
}
}
static final class HttpOrderController {
private final SubmitOrderUseCase useCase;
HttpOrderController(SubmitOrderUseCase useCase) {
this.useCase = useCase;
}
String post(String orderId, int quantity) {
return useCase.handle(new SubmitOrderCommand(orderId, quantity));
}
}
static final class OrderMessageConsumer {
private final SubmitOrderUseCase useCase;
OrderMessageConsumer(SubmitOrderUseCase useCase) {
this.useCase = useCase;
}
String onMessage(String orderId, int quantity) {
return useCase.handle(new SubmitOrderCommand(orderId, quantity));
}
}
static final class OrderRpcEndpoint {
private final SubmitOrderUseCase useCase;
OrderRpcEndpoint(SubmitOrderUseCase useCase) {
this.useCase = useCase;
}
String submit(String orderId, int quantity) {
return useCase.handle(new SubmitOrderCommand(orderId, quantity));
}
}
public static void main(String[] args) {
SubmitOrderUseCase useCase = new SubmitOrderUseCase();
System.out.println(new HttpOrderController(useCase).post("O-100", 2));
System.out.println(new OrderMessageConsumer(useCase).onMessage("O-101", 1));
System.out.println(new OrderRpcEndpoint(useCase).submit("O-102", 3));
}
}预期输出:
accepted:O-100
accepted:O-101
accepted:O-102三个入口的代码不同,只因为它们承担不同的协议适配职责;真正决定“数量必须大于 0”的业务规则只存在于应用用例中。
协议差异应该停在哪里
接口层可以保留各自特有的行为。HTTP 可以把参数错误映射为 400,MQ 可以决定消息失败后是否重试,RPC 可以转换远程异常。这些都不应该强行抽象成一个“万能入口”,否则会把不同协议的语义混在一起。
需要统一的是用例,而不是传输机制。三个入口只要最终构造相同的应用命令,就可以共享权限检查、事务控制、领域调用和 Repository 写入等流程。
处理重试与幂等边界
MQ 常常比 HTTP 更容易发生重复投递,因此接口层可以负责读取消息 ID,但幂等判定通常应落到应用流程或其调用的基础设施能力中,确保同一业务命令无论从哪个入口进入都遵循一致规则。
当 HTTP、MQ 和 RPC 都能独立演进,而它们调用的应用服务仍保持一份时,新的接入方式就只是在系统边缘增加适配器,不会把核心业务复制一遍。这正是多协议入口能够长期共存的关键。