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

HTTP、MQ 和 RPC 入口怎样共存

HTTP、MQ 和 RPC 入口怎样共存

HTTP、MQ 和 RPC 的传输方式、错误模型和请求格式都不同,但它们不应该各自复制一套业务流程。更稳妥的做法是把它们视为不同的接口适配器,统一转换成应用层命令并调用同一个用例。

学习目标

  • 理解多种外部协议如何映射到统一应用层
  • 区分协议适配逻辑与业务用例逻辑
  • 能设计避免 HTTP、MQ、RPC 重复业务代码的入口结构

不同协议只解决接入问题

HTTP 关注 URL、状态码和请求体,MQ 关注消息主题、确认与重试,RPC 关注方法调用和序列化契约。它们的差异是真实存在的,但这些差异主要位于系统边缘。

如果三个入口都在内部重复“校验订单、扣减额度、创建订单、保存结果”,同一用例就会出现三份实现。后续业务规则变化时,很容易只改其中一份,最终让不同入口产生不同结果。

HTTP MQ RPC 统一适配到应用层

统一到应用命令而不是统一协议

应用层不需要知道请求来自 HTTP、Kafka 还是 RPC。它只需要接收能够表达用例意图的命令,例如 SubmitOrderCommand。每个接口适配器负责从自己的协议对象构造该命令,再把应用层结果转换回对应协议。

下面的完整 Java 示例让三个入口调用同一个 SubmitOrderUseCase。为了突出边界,示例只保留最小业务规则。

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

预期输出:

text
accepted:O-100
accepted:O-101
accepted:O-102

三个入口的代码不同,只因为它们承担不同的协议适配职责;真正决定“数量必须大于 0”的业务规则只存在于应用用例中。

协议差异应该停在哪里

接口层可以保留各自特有的行为。HTTP 可以把参数错误映射为 400,MQ 可以决定消息失败后是否重试,RPC 可以转换远程异常。这些都不应该强行抽象成一个“万能入口”,否则会把不同协议的语义混在一起。

需要统一的是用例,而不是传输机制。三个入口只要最终构造相同的应用命令,就可以共享权限检查、事务控制、领域调用和 Repository 写入等流程。

处理重试与幂等边界

MQ 常常比 HTTP 更容易发生重复投递,因此接口层可以负责读取消息 ID,但幂等判定通常应落到应用流程或其调用的基础设施能力中,确保同一业务命令无论从哪个入口进入都遵循一致规则。

当 HTTP、MQ 和 RPC 都能独立演进,而它们调用的应用服务仍保持一份时,新的接入方式就只是在系统边缘增加适配器,不会把核心业务复制一遍。这正是多协议入口能够长期共存的关键。

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

目录与阅读设置

阅读设置

17

记录一个想法

HTTP、MQ 和 RPC 入口怎样共存

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

登录哪都通