跳到正文
D3-05网关与适配层1 分钟更新于 2026-11

报文转换

一句话

转换层只做映射与翻译,不做业务判断——一旦写进 if-else,渠道差异就漏到业务层了。

本文目录6 节

报文转换

一次请求的转换链

flow业务字段到渠道报文
业务字段
字段映射
单位与格式转换
签名
发送

返回方向对称:解析 → 状态映射 → 错误码映射 → 业务语义。

转换层要处理什么

  • 字段名:orderNo / merchantOrderId / out_trade_no
  • 单位:分 ↔ 元、字符串 ↔ 数字
  • 格式:时间戳 ↔ ISO、布尔 ↔ "Y"/"N"
  • 枚举:状态、币种、卡种

不要做什么

  • 不要在这里判断「余额够不够」
  • 不要在这里决定「要不要重试」
  • 不要在这里拼业务文案

这些属于业务层或编排层,转换层只回答「字段怎么对应」。

常见误判

  • 在转换层写渠道专属业务逻辑(越写越厚)
  • 单位转换遗漏(分/元差 100 倍)
  • 状态字符串直接透传(上层无法统一判断)

自查清单

  • 转换层有业务判断吗(不该有)
  • 单位转换有测试吗
  • 状态与错误码都映射了吗
  • 新增渠道只改转换层吗
  • 有渠道级的契约测试吗

依据

相关阅读