Spring Boot六边形架构类划分推荐子包及模板优化咨询

云原生阿岚

2026-7-23

Spring Boot六边形架构：推荐子包结构及示例优化

一、完整推荐子包清单

这部分是业务核心，不依赖任何外部技术实现：

[根包].domain.model：存放领域实体、值对象、聚合根，是业务规则的核心载体
[根包].domain.ports：
- [根包].domain.ports.in：定义入站端口，即外部系统可触发的业务能力接口（比如用户下单、查询订单的用例接口）
- [根包].domain.ports.out：定义出站端口，即领域层需依赖的外部资源接口（比如订单持久化、发送通知的接口）
[根包].domain.services：领域服务，处理跨聚合的复杂业务逻辑（单一聚合可完成的逻辑直接放在实体中）
[根包].domain.events：领域事件，用于领域内或跨领域的事件通知（比如订单创建后触发库存扣减事件）
[根包].domain.exceptions：自定义领域异常，封装业务相关错误（比如“库存不足”“用户不存在”）
[根包].domain.specifications：业务规则规范，集中管理复杂业务约束（比如“用户必须实名认证才能下单”）

这部分负责接收外部请求，转换后调用领域层的入站端口：

这部分实现领域层定义的出站端口，对接外部资源：

你提到的示例模板已经覆盖了核心结构，但针对大型Spring Boot应用，还需要做这些优化：

拆分ports子包：示例里的domain.ports未区分入站和出站端口，建议拆成domain.ports.in和domain.ports.out。前者定义外部可调用的业务接口，后者定义领域需要的外部资源接口，职责更清晰，避免端口混淆。
补充领域辅助模块：添加domain.events、domain.exceptions、domain.specifications：
- domain.events：处理领域事件的发布与订阅，实现业务解耦；
- domain.exceptions：把业务错误封装成自定义异常，与技术异常区分开，方便统一处理；
- domain.specifications：把复杂业务规则抽离出来，让领域实体更简洁，规则也更容易复用。

细化REST适配器结构：示例里的adapters.inbound.rest只有一层，建议拆分出controllers、dtos、mappers、validators子包，把控制器、数据传输对象、转换工具、校验器分开，符合单一职责原则，代码更易维护。
扩展适配器类型：根据业务需求添加cli、graphql等子包，覆盖不同的外部访问方式。
消息消费者分层：在adapters.inbound.bus下添加listeners子包，专门存放消息监听器类，与dtos、mappers分开，结构更清晰。

数据库适配器加配置子包：添加adapters.outbound.db.config，存放数据库相关的配置类，避免配置类散落在根包或其他业务包中。
新增外部API适配器：大型应用通常会依赖第三方服务，添加adapters.outbound.external子包专门处理这类调用，示例模板未覆盖这部分。
新增缓存适配器：缓存是大型应用性能优化的关键，添加adapters.outbound.cache子包，封装Redis等缓存操作，实现领域层定义的缓存端口。
消息生产者分层：在adapters.outbound.bus下添加producers子包，专门存放消息生产者类，职责更明确。

添加根包下的config子包，专门存放Spring Bean的注册配置，比如把出站适配器的实现绑定到领域层的出站端口，避免配置类和业务代码混杂。

内容的提问来源于stack exchange，提问作者Marc Le Bihan