Skip to main content

1 / 4概念

Layered Architecture

分层架构不是把代码切成四个文件夹,而是让源码依赖只朝一个方向:外层知道内层,内层不知道外层。判断一次分层是否成立,只看一条:把 UI、数据库或框架换掉时,领域代码是否需要修改。

1 概念​

1.1 一句话定义​

分层架构把系统按职责分成若干层,并规定源码依赖从外层指向内层;内层定义业务规则和抽象接口,外层提供框架、协议、存储等具体实现。Clean Architecture、Hexagonal Architecture 和 Onion Architecture 是这条规则的不同画法。

1.2 它解决什么问题​

  • 业务规则散落在 Controller、SQL 和前端校验里,改一个规则要改三处。
  • 单元测试必须启动数据库或 Web 容器,反馈从毫秒变成秒级。
  • 换 ORM、换消息队列、换 Web 框架时,领域代码被一起拖下水。
  • 同一个用例被 HTTP、定时任务和消息消费者复用,却没有稳定的调用入口。

分层把“做什么”和“怎么做”分开:用例和领域模型回答做什么,适配器回答怎么做。

1.3 不属于本页的内容​

主题去哪
服务拆分、独立部署与数据所有权Microservices
限界上下文、聚合与通用语言Domain-Driven Design
事件、CQRS 与最终一致性Event-Driven Architecture
面向客户端的聚合层BFF
依赖注入容器与框架生命周期各语言生态的 Runtime / Toolchain 页

1.4 关键术语​

术语含义容易混淆的点
依赖规则源码依赖只能由外向内不是运行时调用方向
端口内层定义的抽象接口不是网络端口
适配器实现端口的外层代码不是设计模式里的 Adapter
用例一次业务动作的编排入口不是 Controller 方法
领域模型业务概念、规则与不变量不是数据库表结构
DTO跨边界传输的数据形状不是领域实体
组合根在进程入口完成依赖装配的地方不是业务层
贫血模型只有字段和 getter/setter 的对象不是“简单的领域模型”