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。原文保存於我們的雲端服務商,可應要求刪除。 完整私隱政策 ▸