跳到正文
D1-06领域模型1 分钟更新于 2026-11

防腐层

一句话

外部模型不能直接进你的领域,要有翻译层。

本文目录8 节

防腐层

它解决什么

外部系统(渠道、银行、合作方)的模型不该直接进入你的领域。防腐层做翻译:把渠道的字段、状态、错误码,翻成你的领域语言。没有这层,渠道改一个字段名,业务代码就得跟着改。

怎么用

  • 渠道模型只出现在适配层
  • 领域层不 import 外部包
  • 翻译规则可配置

一个判断

业务代码里出现 orderNo、out_trade_no 这类渠道字段名,说明防腐层没做。

边界

防腐层解决模型污染,不解决语义缺失。渠道不给的信息(比如没有失败原因),翻译层也变不出来。

一个反例

某业务代码里直接出现 orderNo、out_trade_no 两种字段名,渠道一改字段,业务层跟着发版,半年改了 12 次。加了防腐层后,渠道改名只改一个映射文件。

常见误判

  • 把渠道字段透传到业务层。

自查清单

  • 知道这个模块的边界在哪
  • 知道它的状态机有哪几个状态
  • 知道它出错时的兜底路径
  • 知道它的数据存在哪张表

依据

  • 防腐层(ACL)的作用。

相关:适配器契约的五个字段

相关阅读