Trigpoint

本页由繁体中文版自动转换

Collections 书架 › Software & Systems Architecture 软体与系统架构 › Hexagonal Architecture (Ports and Adapters) 六角架构
「包一层介面就算解耦」:未必。

六角架构

Hexagonal Architecture (Ports and Adapters) · Cockburn (2005)
已对照来源本身 ✓ 软体架构 · 依赖方向 先读:领域驱动设计 私下告诉编辑 ▸
三句讲透 核心用自己的语汇定义介面:外界可以要它做什么,它又需要外界提供什么。
执行时,核心可以经介面去呼叫资料库;程式码的依赖却一律由外指向内,核心不认识任何具体技术。
判准:接上测试输入与假转接,核心能否不靠真实资料库、介面或外部服务,独立执行并验证其业务规则。

↳ 见过反例?

成立条件
同一个核心要被人、测试、批次等多种方式驱动,或外部技术需要抽换时。
证据强度
概念框架;已对照来源本身
失效样貌
介面迁就工具而非核心,或用在不需抽换的地方:多了一层,却没换来任何弹性。
六角架构 Cockburn (2005) Hexagonal Architecture (Ports and Adapters) 外围怎么换,核心都不必知道 转接层:每种技术各写一个转接 介面层:核心宣告的有目的对话 核心 业务规则,只认介面 主动侧 人来操作 自动化测试 批次或另一个程式 被动侧 资料库 外部系统 记忆体内的假转接 箭头=依赖:转接认得核心,核心不认得转接 执行时:核心 → 介面 → 资料库转接 → 资料库 程式码:资料库转接依照核心定义的介面写成 图:trigpoint.pub
图 1 · 由内往外三层:核心、核心定义的介面、各技术的转接。
图中箭头只画程式码依赖,不画执行时的呼叫顺序。
左侧主动侧发起要求,右侧被动侧由核心呼叫。
底部以一次资料库存取为例,对照两种方向。
层系为概念示意,不画成六边,不含任何量测数字。 放大看图 ▸

一、发生什么事

作者当年要处理的病症很具体,而且与测试有关:业务逻辑渗进了介面层,于是系统没办法被自动化测试驱动,也很难从「人来操作」切换到「批次跑」或「另一个程式来呼叫」。

根因是依赖的方向错了:核心去认识了具体技术(某个资料库驱动、某个介面框架)。一旦如此,你要测核心就得先把那些技术架起来。

这套架构把方向反过来:介面由核心定义,技术只在外围写转接[1]Cockburn, A. (2005, September 4). The Hexagonal (Ports & Adapters) Architecture. HaT Technical Report 2005.02, v0.9. alistair.cockburn.us/hexagonal-architecture/. 书目经官方记录核对。主张已对照全文核实。意图逐字:让一个应用能同等地被使用者、程式、自动化测试或批次脚本驱动,并且能在脱离其最终执行期装置与资料库的情况下开发与测试。。介面是核心定义的、与技术无关的一段「有目的的对话」,分两种:一种说明外界可以要核心做什么,一种说明核心需要外界提供什么。两侧转接与介面的关系因此不同:主动侧的转接把网页请求、命令列等输入转成对核心的呼叫;被动侧的转接依核心定义的介面写成,把核心的要求转成资料库查询或外部服务的呼叫。

最容易混淆的是两种方向。执行一次需要资料的操作时,呼叫由核心经介面往外,到资料库转接,再到资料库,结果沿原路回到核心。程式码的依赖却反过来:是资料库转接依照核心的介面写成,核心从不引用它。所以核心里写的是「储存这篇文章」,而不是某个资料库用户端的插入指令;要测核心,接一个记忆体内的假转接即可。

作者原文的意图那句话值得逐字留着:让一个应用能同等地被使用者、程式、自动化测试或批次脚本驱动,并且能在脱离其最终执行期装置与资料库的情况下开发与测试[1]Cockburn, A. (2005, September 4). The Hexagonal (Ports & Adapters) Architecture. HaT Technical Report 2005.02, v0.9. alistair.cockburn.us/hexagonal-architecture/. 书目经官方记录核对。主张已对照全文核实。意图逐字:让一个应用能同等地被使用者、程式、自动化测试或批次脚本驱动,并且能在脱离其最终执行期装置与资料库的情况下开发与测试。。

Cockburn 2005 年的报告强调对称:图上没有上层下层,资料库与使用者介面同样只是接在某个介面上的外部技术。主动侧(推核心的:人、测试、批次)与被动侧(被核心呼叫的:资料库、外部系统)的区别,在于谁发起、主导这段对话,不在架构层级[1]Cockburn, A. (2005, September 4). The Hexagonal (Ports & Adapters) Architecture. HaT Technical Report 2005.02, v0.9. alistair.cockburn.us/hexagonal-architecture/. 书目经官方记录核对。主张已对照全文核实。意图逐字:让一个应用能同等地被使用者、程式、自动化测试或批次脚本驱动,并且能在脱离其最终执行期装置与资料库的情况下开发与测试。。但对称只在架构图上成立:作者 2020 年受访时自述,驱动侧与被驱动侧的转接终究无法写成同一种,他追求的完全对称因此落空[5]Garrido de Paz, J. M. (2020, September 9). Interview with Alistair Cockburn. jmgarridopaz.github.io/content/interviewalistair.html. 书目经官方记录核对。主张已对照全文核实。作者受访自述(第一人称):1994 年在物件导向程式设计课的讲义上第一次画出六边形;最初发表时没有 Ports and Adapters 这个名字;2005 年 6 月才想通六边的每一面就是一个介面(port),同月在 wiki 上建立以 Ports and Adapters 为名的页面。他想通的是介面与转接,不是对称性。他也说,驱动侧与被驱动侧的转接终究无法写成同一种,完全对称的追求因此落空。。

二、为什么这对你重要

把「技术」换成「工具与模型」,这页就变成一个很实际的建议:你的判准不该绑定某个工具。

现在很多人的工作流是反过来的:判准长在工具里。提示词写在某个平台的专案设定里、分类规则写在某个笔记软体的栏位里、检查清单存在某个服务的模板里。这在单一工具好用时完全没问题,直到你要换工具、或要用第二个工具做同一件事、或那个工具改了它的功能。

这套架构的做法是把方向反过来:判准写在你自己的地方,用你自己的语汇宣告「我需要什么样的输入与输出」,然后每个工具各写一层薄薄的接法。换工具时你只换接法,判准不动。反过来,若你只在一个工具里做这件事、也没打算换,先把判准写清楚就够,不必急着替它搭接法。

它同时给你一个可验证的判准,这是这页最有价值的部分。不是问「我有没有解耦」(这个问题没有答案),而是问:我的判准能不能在没有任何特定工具的情况下被说清楚、被人执行。 如果你的分类规则要靠某个软体的栏位才讲得通,那它已经绑死了。

反过来也要提防那个假解耦。在工具外面包一层,但那层的形状完全照着工具长:例如你的规格里写满某个平台的专有名词。这在形式上是多了一层,在实质上什么都没换到,因为换工具时那层要整个重写。介面的形状必须由核心决定,这是原则里最容易被跳过的一句。

验证层 · 会员
这个节点的导读公开阅读。
验证细节与失效边界属会员版。
平均每月 US$8.25 · 亦可按月订阅 ▸

Lab 实测 有实测才写

本节点暂无实测。

常见误读

所属页核验:已对照来源本身 ✓ · 内容最后修订 2026-11-15

  • 常见转述「六边代表六个层或六种介面」:六边只是画图方便,作者选它是为了留出空间画多个介面,不受一维分层图的限制。纠结边数是抓错重点。名称方面,Cockburn 2005 年的报告以 Ports and Adapters 为模式名,六边形架构列为别名;据作者 2020 年受访自述,六边形 1994 年已画出,2005 年 6 月才改以 Ports and Adapters 为名。原文也把它写成转接器模式的一种特定用法,并列出几个相近的既有模式,故本站标作者为提出者兼命名者,不标为无前例的首创。 #
  • 常见转述「洋葱架构与整洁架构是这套的衍生版」:三者同家族、不同作者、各自命名,共享的是依赖只向内这个原则。作者归属不可混。 #
参考文献

如何阅读来源注记 「书目经…核对」指作者、年份、题名与出版项已确认;不代表该来源的主张已被核对。「对照全文核实」指主张已与来源文本本身比对。 定义版本:2026-09-20。

  1. [1] Cockburn, A. (2005). The Hexagonal (Ports & Adapters) Architecture. HaT Technical Report 2005.02. alistair.cockburn.us/hexagonal-architecture/ ↩
  2. [5] Garrido de Paz, J. M. (2020). Interview with Alistair Cockburn. jmgarridopaz.github.io/content/interviewalistair.html ↩

↳ 引注有误?

新书架开架时通知我

新书架开架时通知我

开架通知只在新书架开架或阅读规则变更时寄出。

试行

私下告诉编辑:更正、反例或适用性

提交只供编辑阅读,处理前不公开;处理后,编辑撰写的摘要与回应才会刊出。提交毋须注册,昵称可留空。

你想提交的是
设定公开名称后,可选择以名称致谢 ▸
不登入,直接匿名提交

登入后可在「我的」页追踪处理状态。你写的内容会保留。

你已登入:本件会连结到你的帐号,只有你和编辑看得到,方便你在「我的」页追踪状态。原文不会公开。 完整私隐政策 ▸

不连到帐号,改为匿名提交 ▸

不收集电邮。你的原文与昵称只供编辑阅读,不会公开;站上只刊载编辑撰写的摘要。真人验证由 Cloudflare Turnstile 提供;为限制滥用,系统只保存 IP 的杂凑值,不保存明文 IP。原文保存于我们的云端服务商,可应要求删除。 完整私隐政策 ▸