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

协议差异

一句话

签名、编码、字段名、金额单位、时间格式、错误码——六个地方每家都不一样,全靠适配器翻译。

本文目录8 节

协议差异

它解决什么

渠道协议有六处差异:签名(RSA/HMAC)、编码(表单/JSON/XML)、字段名、金额单位(分/元)、时间格式、错误码。适配器的职责就是把这些翻译成统一语义,业务层不该知道任何渠道字段名。任何一处翻译错了,都会在某个渠道上以奇怪的方式失败。

怎么用

  • 业务字段映射
  • 单位统一为分
  • 时间统一 UTC
  • 错误码映射

一个判断

某系统把元当分传给渠道,一笔 100 元变成 1 元,当天 200 笔全部金额错。

边界

协议的边界是「金额单位」:分与元差 100 倍,且不会报错,只会金额错。

一个反例

某系统把元当分传给渠道,一笔 100 元变成 1 元,当天 200 笔全部金额错。现在统一用最小单位,适配器做单位转换测试。

常见误判

  • 把渠道响应透传给业务层(改字段名就崩)
  • 金额单位混用(分/元错一位就是 100 倍)
  • 时间按本地时区解析(跨时区差错)

自查清单

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

依据

  • 渠道协议的主要差异点

相关:通道管理系统设计

相关阅读