D3-05网关与适配层1 分钟更新于 2026-11
报文转换
一句话
转换层只做映射与翻译,不做业务判断——一旦写进 if-else,渠道差异就漏到业务层了。
报文转换
一次请求的转换链
flow业务字段到渠道报文
业务字段
字段映射
单位与格式转换
签名
发送
返回方向对称:解析 → 状态映射 → 错误码映射 → 业务语义。
转换层要处理什么
- 字段名:
orderNo/merchantOrderId/out_trade_no - 单位:分 ↔ 元、字符串 ↔ 数字
- 格式:时间戳 ↔ ISO、布尔 ↔ "Y"/"N"
- 枚举:状态、币种、卡种
不要做什么
- 不要在这里判断「余额够不够」
- 不要在这里决定「要不要重试」
- 不要在这里拼业务文案
这些属于业务层或编排层,转换层只回答「字段怎么对应」。
常见误判
- 在转换层写渠道专属业务逻辑(越写越厚)
- 单位转换遗漏(分/元差 100 倍)
- 状态字符串直接透传(上层无法统一判断)
自查清单
- 转换层有业务判断吗(不该有)
- 单位转换有测试吗
- 状态与错误码都映射了吗
- 新增渠道只改转换层吗
- 有渠道级的契约测试吗
依据
- 防腐层的职责边界
- 协议差异,见 协议差异
- 相关:适配器契约的五个字段
相关阅读