作者背景#

Tom Hombergs 是長年活躍於 Java 生態系的軟體工程師，十多年來在不同產業的專案中兼任開發者、架構師與教練。他相信「寫作是最好的學習方式」，因此持續在個人技術部落格 reflectoring.io 上深入剖析軟體開發主題，並偶於研討會演講。他也是軟體架構文件範本 arc42.org 的共同創辦人，以及國際軟體架構認證機構 iSAQB（International Software Architecture Qualification Board）的創始成員。撰寫本書時，這些一手的專案經驗與架構教學背景，讓全書始終以「實際動手」與「可維護性」為主軸，而非停留在抽象的架構圖討論。本書第一版於 2019 年出版，後續推出擴充的第二版。

完整摘要#

本書要解決的核心問題是：傳統三層架構（Web 層、領域層、持久化層）雖是紮實的模式，卻因依賴方向全部疊在資料庫之上而對變更格外脆弱。作者指出它助長「以資料庫為中心」的設計、容許開發者把元件下推以抄捷徑、使領域邏輯散落各層而越來越難測試，並隱藏使用案例、阻礙平行開發。

作者提出的替代方案，是以兩個 SOLID 原則為地基的整潔架構／六角架構。透過單一職責原則（理解為「單一改變理由」）與依賴反轉原則（Dependency Inversion Principle），他把依賴方向反轉，讓所有跨層依賴都指向內側的領域程式碼，使領域邏輯不再依賴持久化與 UI 技術。對應的具體機制是「埠與配接器」（Ports and Adapters）：應用核心定義並擁有對外的埠（port）介面，外部的驅動配接器與被驅動配接器再去配合這些介面。

全書後半是逐步的實作指南。作者以一個富表達力的套件結構（adapter／application／domain／port）縮小「架構與程式碼的落差」，接著依序示範如何實作使用案例（為每個案例建立狹窄服務與專屬輸入輸出模型、在輸入模型建構子中做驗證）、Web 配接器、持久化配接器（以 Spring Data JPA 為例，並套用介面隔離原則切分埠），再用測試金字塔為各架構元素配置單元、整合與系統測試。後續章節處理層間對映策略（不對映、雙向、完整、單向）、依賴注入與應用組裝、有意識地走捷徑、以 ArchUnit 與建置產物強制架構邊界，以及如何管理多個限界上下文（bounded context）。

結論並不教條：作者強調架構應隨需求演進，主張先從簡單起步、必要時再導入六角架構；最終是否採用，取決於領域程式碼是否為應用中最重要的部分，以及團隊的經驗——一切「看情況」。

本書的貢獻與定位#

相較於 Robert C. Martin 的《Clean Architecture》與 Alistair Cockburn 提出的六角架構偏重概念，本書的獨特貢獻在於把這些抽象原則落實為可執行的 Java／Spring 程式碼，填補了「理論架構圖」與「實際套件、類別、測試與建置設定」之間的落差。它不追求放諸四海皆準的鐵律，而是逐一檢視每個設計決策的取捨與捷徑代價，並反覆以「可維護性」作為判準。主要受眾是已熟悉分層架構、想理解六角架構如何在真實專案中運作的 Java 開發者與架構師；適用情境是領域邏輯複雜、需長期演進的應用，而非單純的 CRUD 系統。