You need to enable JavaScript to run this app. Robert C. Martin《整洁架构》疑问:为何Entities不允许跨边界?
优惠活动
大模型
产品
解决方案
定价
更多

Robert C. Martin《整洁架构》疑问:为何Entities不允许跨边界?

核心概念澄清:整洁架构下的“跨边界”定义

两个先破掉的常见认知误区

  • 不存在“混淆方法调用和数据穿越”的问题,这俩本来就是两个独立的设计约束,也是整洁架构做分层隔离的核心抓手
  • 接口适配器层根本不会直接使用核心Entity——这是绝大多数人对整洁架构图的误读:图上的箭头标注的是依赖方向,不是对象的流动路径

到底什么是“跨边界”

整洁架构的边界从来不是代码文件的物理存放文件夹,而是依赖方向的隔离线:所有箭头永远从外层指向内层,外层代码可以感知内层的存在,内层代码必须对所有外层的具体实现完全无感知。
所谓“跨边界传数据”,特指数据流穿过这条隔离线的动作:包括外层调用内层方法时的入参、内层调用外层接口时的入参、方法返回值从一侧流向另一侧的全流程。

为什么跨边界不能传Entity或者数据库行对象

先厘清两类对象的本质区别

  • 数据库行对象(比如各类ORM框架定义的RowStructure)是外层技术栈的专属结构,绑定了数据库表结构、框架注解,本来就不应该流入内层——如果内层感知到这类对象,就等于被外层技术规则绑死,换个数据库框架就要改动核心业务逻辑,这部分的认知你是对的。
  • 核心Entity是封装了核心业务规则的带行为对象:它不是只有字段的数据袋,而是承载了比如「用户满18岁才能投票」「订单满200自动减30」这类业务逻辑的领域对象,存在的核心意义是保护核心业务规则不被外围细节篡改。

禁止Entity跨边界的核心逻辑

如果把带业务行为的Entity直接传到外层(ORM层、Web层、第三方服务层都算),外层代码很容易为了适配自身需求(比如序列化JSON、映射数据库行、对接第三方接口)直接修改Entity的内部状态、给Entity加无业务意义的setter、甚至往Entity里塞适配外层的冗余字段。长此以往,本来纯粹保护业务规则的Entity会被外围的各种需求污染,变成绑定了数据库结构、前端接口格式的四不像,完全失去核心层的独立性。
Uncle Bob提到的“投机取巧”,本质就是很多人图字段重合的便利,直接把Entity当跨边界的DTO用,最终把核心层和外围技术栈强绑定,完全违背架构的隔离目标。

正确的跨边界流转逻辑

跨边界传递的必须是无行为、无框架依赖、无业务逻辑的纯数据结构:

  • 外层从数据库拿到ORM行对象后,先转成纯数据DTO,传给内层用例层
  • 内层用例层收到DTO后,把数据装配成带业务行为的Entity,执行对应的业务规则
  • 业务执行完成后,把需要传出的数据重新拆成纯DTO,传给外层
  • 外层收到DTO后,再转成自己需要的格式(比如前端视图模型、ORM行对象、第三方接口请求结构)做后续处理

Entity的流动范围严格限制在实体层、用例层的内部,根本不会越过隔离线到达接口适配器、数据库、UI这些外层模块——这才是架构图箭头的正确含义:外层依赖内层定义的抽象接口,内层不感知外层的实现细节,跨边界传递的是双方约定的纯数据,不是带行为的核心Entity。

内容的提问来源于stack exchange,提问作者Sebi

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.12 10:06:04