D1-06领域模型1 分钟更新于 2026-11
防腐层
一句话
外部模型不能直接进你的领域,要有翻译层。
防腐层
它解决什么
外部系统(渠道、银行、合作方)的模型不该直接进入你的领域。防腐层做翻译:把渠道的字段、状态、错误码,翻成你的领域语言。没有这层,渠道改一个字段名,业务代码就得跟着改。
怎么用
- 渠道模型只出现在适配层
- 领域层不 import 外部包
- 翻译规则可配置
一个判断
业务代码里出现 orderNo、out_trade_no 这类渠道字段名,说明防腐层没做。
边界
防腐层解决模型污染,不解决语义缺失。渠道不给的信息(比如没有失败原因),翻译层也变不出来。
一个反例
某业务代码里直接出现 orderNo、out_trade_no 两种字段名,渠道一改字段,业务层跟着发版,半年改了 12 次。加了防腐层后,渠道改名只改一个映射文件。
常见误判
- 把渠道字段透传到业务层。
自查清单
- 知道这个模块的边界在哪
- 知道它的状态机有哪几个状态
- 知道它出错时的兜底路径
- 知道它的数据存在哪张表
依据
- 防腐层(ACL)的作用。
相关:适配器契约的五个字段
相关阅读