4.2.1.1 驱动端口与驱动适配器

文档摘要

4.2.1.1 驱动端口与驱动适配器当驱动适配器开始“撒谎”：一个被忽略的端口契约失效现场——记一次因误用导致六边形架构驱动端口语义崩塌的真实故障凌晨两点十七分，告警平台弹出第13条。不是数据库连接超时，不是Redis响应延迟，而是一笔本该完成支付的订单，在调用后，状态仍卡在。日志里没有异常堆栈，没有SQL报错，只有三行平静得令人窒息的记录：可订单状态，就是没变。这不是 bug —— 至少不是传统意义上的 bug。这是六边形架构的契约失语症：驱动端口（Driving Port）在说“我完成了”，而驱动适配器（Driving Adapter）却悄悄把承诺吞进了事务的黑箱里。它没撒谎，但它说了半句真话；它没失败，但它让“完成”二字失去了业务意义。