这篇我想按“排查记录”来写，主题是 DTO、VO、Entity 分不清会带来什么麻烦。这种写法比纯概念文更适合我自己回看。

现象先别急着解释

对象分层是为了隔离变化，不是为了多写几个类。

先把现象钉住，比急着下结论有用。很多时候真正的关键不是“答案是什么”，而是“我是怎么一步步排到这里的”。

我会先看哪几件事

  • Entity 对应持久化结构
  • DTO 承载接口入参
  • VO 面向页面展示
  • 转换逻辑要集中

带入一个排查场景

给用户列表接口设计查询 DTO 和返回 VO。

如果这是线上问题，我通常会先保留日志和上下文，再去缩小范围：是入参问题、状态问题、并发问题、数据库问题，还是调用链上的某一环超时了。

排查时能落地的片段

1
2
3
4
5
public Result<Void> handle(Command command) {
    validator.check(command);
    service.execute(command);
    return Result.ok();
}

我比较在意的是这段代码能不能帮我继续观察，而不是它看起来是否“完整”。

写给自己的复盘

  • 下次再遇到类似问题，先证据、后判断。
  • 能打印的关键日志别省。
  • 结论一定要能回到文档、代码或命令结果上。

参考资料