架构与系统设计 / 系统课时
转换代码很多是不是架构有问题
转换代码很多是不是架构有问题
当 DTO、领域对象和持久化对象被刻意分开后,项目里常会出现一批转换方法,看起来像“重复劳动”。真正要判断的不是代码行数,而是这些转换是否在保护模型边界,以及重复是否已经高到值得用工具治理。
学习目标
- 判断显式模型转换何时是在保护边界,而不是无意义样板代码
- 理解 DTO、领域对象与持久化对象之间为什么不应默认共用同一类型
- 知道何时可以引入映射工具,并保留业务语义和依赖方向
转换多不等于设计坏
同一个“订单”在不同边界里承担的职责并不一样。接口 DTO 关心请求字段和协议兼容;领域对象关心业务不变量;持久化对象关心表结构、主键和存储细节。把三者合成一个类,代码会暂时变少,但任何一层字段变化都可能穿透到其他层。
因此,转换代码本身是一种隔离成本。它把“外部输入如何解释成业务含义”和“业务状态如何落到存储结构”明确写在边界处。只要转换逻辑集中、命名清楚、变化方向可控,这些代码通常是在换取更低的耦合,而不是架构失控。

用可运行示例看转换的价值
下面的 Java 17 示例故意保留三种模型。请求对象允许表达接口输入,领域对象在构造时校验数量,持久化对象则额外拥有数据库主键。转换类只负责跨边界搬运和解释数据。
public class ConversionBoundaryDemo {
record CreateOrderRequest(String customerId, int quantity) {}
record Order(String customerId, int quantity) {
Order {
if (customerId == null || customerId.isBlank()) {
throw new IllegalArgumentException("customerId required");
}
if (quantity <= 0) {
throw new IllegalArgumentException("quantity must be positive");
}
}
}
record OrderRow(long id, String customerId, int quantity) {}
static final class OrderMapper {
static Order toDomain(CreateOrderRequest request) {
return new Order(request.customerId(), request.quantity());
}
static OrderRow toRow(long id, Order order) {
return new OrderRow(id, order.customerId(), order.quantity());
}
}
public static void main(String[] args) {
CreateOrderRequest request = new CreateOrderRequest("C-100", 2);
Order order = OrderMapper.toDomain(request);
OrderRow row = OrderMapper.toRow(42L, order);
System.out.println(order);
System.out.println(row);
}
}预期输出
Order[customerId=C-100, quantity=2]
OrderRow[id=42, customerId=C-100, quantity=2]这里的关键不是 OrderMapper 有几行,而是领域对象没有出现数据库主键生成规则,也没有为了接口兼容而接受无效数量。边界变化被限制在转换位置,核心业务规则仍留在领域模型内部。
什么时候该减少手写代码
如果大量转换只是名称和类型完全一致的机械复制,可以使用代码生成型映射工具减少样板代码,但应把工具限制在边界适配层。涉及状态计算、默认值、单位换算、权限裁剪或业务校验的转换,仍应显式表达,避免把业务含义藏进自动映射配置。
反过来,如果一个简单 CRUD 模块中的 DTO、领域模型和数据库记录长期完全同构,而且没有独立业务规则,强行拆成三套类型可能只会增加维护成本。此时可以合并部分模型,但应确认这是基于稳定边界做出的取舍,而不是为了消灭几行转换代码。
判断是否真的出现架构问题
转换代码值得治理,通常不是因为“多”,而是出现了更具体的信号:同一字段规则在多个 Mapper 中重复实现;转换类开始直接访问数据库或远程服务;领域规则被搬到转换层;模型每改一个字段就必须修改大量无关模块。
处理这些问题时,优先收敛转换入口、复用纯粹的值对象转换,并让每个 Mapper 只服务明确边界。工具可以降低机械复制成本,但不能替代边界设计;保留模型隔离,同时让重复保持可控,才是转换代码应达到的状态。