架构与系统设计 / 系统课时
按 layer 分包有什么问题
按 layer 分包有什么问题
把所有 Controller、Service、Repository 分别放进三个全局包,在小项目里直观,但业务一多就会把同一能力拆散到目录两端。本节从维护、依赖和演进三个角度分析这种组织方式何时开始失效,以及如何判断是否需要转向按业务能力组织。
学习目标
- 解释全局按 layer 分包在业务增长后的主要维护成本
- 从一次需求修改判断代码是否被目录结构过度分散
- 理解按业务模块聚合代码时,分层边界应该如何保留
小项目为什么看起来很顺手
典型的 layer 分包把所有入口放在 controller,所有用例放在 service,所有持久化代码放在 repository。类不多时,开发者能快速猜到“某种技术角色”应该放哪里,Spring Boot 的组件扫描也不会因此受影响。
下面是目录片段示例,只用于展示同一个订单能力会被拆到不同全局目录,不是可执行命令。
src/main/java/com/example/controller/OrderController.java
src/main/java/com/example/service/OrderService.java
src/main/java/com/example/repository/OrderRepository.java真正的问题出现在业务维度增多之后。一个“取消订单”需求可能同时修改 Controller、Application Service、领域对象、Repository 接口和持久化实现。目录按技术角色切开后,代码浏览路径与需求理解路径不再一致。
维护成本会随着业务线放大
当 controller 目录里同时出现订单、支付、会员、库存、营销等几十个入口时,包名只能回答“它是什么技术角色”,却不能回答“它属于哪个业务能力”。开发者查一个需求时,需要在多个顶层包之间来回跳转,代码评审也更难一眼确认本次变更是否遗漏某个业务边界。
全局 service 包还容易演化成“公共服务集合”。因为所有服务天然相邻,跨业务注入和随手复用的成本很低,久而久之会出现订单服务直接调用会员服务内部方法、支付服务依赖库存服务实现类等耦合。目录结构没有制造这些依赖,但它降低了建立错误依赖的心理和操作门槛。
从一次变更判断结构是否开始失效
可以用“修改一个业务用例时要跨多少个顶层目录”做诊断。如果一个普通需求经常需要在 controller、service、repository、entity、dto、config 之间反复切换,就说明项目的主要变化轴已经从技术层转向业务能力。
另一个信号是命名开始承担过多上下文,例如 OrderCreateService、OrderCancelService、OrderQueryService 全部堆在同一个 service 包,而它们真正共享的是“订单”边界。此时继续扩大全局 layer 包,只会让同业务高内聚代码在物理结构上越来越分散。

按业务模块组织不等于取消分层
更合适的替代方式通常不是把所有类扔进 order 一个包,而是先按业务能力形成模块,再在模块内部保留必要分层。例如订单模块内部仍然可以有接口层、应用层、领域层和基础设施层,只是这些代码围绕同一业务上下文放在一起。
这种组织方式把“业务边界”提升为第一层导航,把“技术角色”变成模块内部的第二层导航。开发者处理订单需求时,大部分修改都集中在订单模块内;支付和会员模块则拥有自己的模型与应用服务,跨模块依赖也更容易被看见和审查。
什么时候仍然可以按 layer 分包
如果项目很小、业务单一、团队人数少,而且代码量长期可控,全局 layer 分包没有必要为了形式而重构。结构是否合适应由变化成本决定,而不是由目录风格决定。
当业务模块已经稳定出现、一次需求频繁跨多个顶层包、不同业务之间开始产生难以解释的 Service 互调时,按业务能力重新组织通常更有价值。目录调整的目标不是“看起来更像 DDD”,而是让代码的物理位置更接近团队理解和修改业务的方式。