架构与系统设计 / 系统课时

按 layer 分包有什么问题

按 layer 分包有什么问题

把所有 Controller、Service、Repository 分别放进三个全局包,在小项目里直观,但业务一多就会把同一能力拆散到目录两端。本节从维护、依赖和演进三个角度分析这种组织方式何时开始失效,以及如何判断是否需要转向按业务能力组织。

学习目标

  • 解释全局按 layer 分包在业务增长后的主要维护成本
  • 从一次需求修改判断代码是否被目录结构过度分散
  • 理解按业务模块聚合代码时,分层边界应该如何保留

小项目为什么看起来很顺手

典型的 layer 分包把所有入口放在 controller,所有用例放在 service,所有持久化代码放在 repository。类不多时,开发者能快速猜到“某种技术角色”应该放哪里,Spring Boot 的组件扫描也不会因此受影响。

下面是目录片段示例,只用于展示同一个订单能力会被拆到不同全局目录,不是可执行命令。

text
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 包,只会让同业务高内聚代码在物理结构上越来越分散。

按 layer 分包与按业务模块组织的对比结构

按业务模块组织不等于取消分层

更合适的替代方式通常不是把所有类扔进 order 一个包,而是先按业务能力形成模块,再在模块内部保留必要分层。例如订单模块内部仍然可以有接口层、应用层、领域层和基础设施层,只是这些代码围绕同一业务上下文放在一起。

这种组织方式把“业务边界”提升为第一层导航,把“技术角色”变成模块内部的第二层导航。开发者处理订单需求时,大部分修改都集中在订单模块内;支付和会员模块则拥有自己的模型与应用服务,跨模块依赖也更容易被看见和审查。

什么时候仍然可以按 layer 分包

如果项目很小、业务单一、团队人数少,而且代码量长期可控,全局 layer 分包没有必要为了形式而重构。结构是否合适应由变化成本决定,而不是由目录风格决定。

当业务模块已经稳定出现、一次需求频繁跨多个顶层包、不同业务之间开始产生难以解释的 Service 互调时,按业务能力重新组织通常更有价值。目录调整的目标不是“看起来更像 DDD”,而是让代码的物理位置更接近团队理解和修改业务的方式。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

按 layer 分包有什么问题

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通