Skip to content

模拟联调通道:设计架构 ​

更新时间:2026/11/10 10:51:10

这一页讲四件事:这条链路由哪几个进程组成、请求怎么走、对外暴露哪两类协议面、数据存在哪里。不涉及代码结构和类设计。

组件边界 ​

模拟联调通道不直接面对主应用,而是站在通道子应用身后,扮演「三方支付平台」这一角色:

角色职责不做什么
主应用装配 daxpay-channel-mock 编排模块、维护通道商户与路由、接收回调并推进订单不直连 mock 服务
通道子应用按通道协议把平台请求翻译成网关报文,验签、解析响应与回调不持有 mock 数据
模拟联调通道拟真交易结果、落单留痕、按规则发回调、提供管理台不连数据库、不连 MQ、不碰真实通道

为什么不让主应用直连

mock 服务走的是「开放接口风格」的网关契约(RSA 双向签名、防重放头、snake_case 报文),与真实通道对接通道子应用的方式一致。让通道子应用出站,mock 才能同时验证签名、报文字段和回调解析,而不只是把返回码写死。

两条协议面 ​

协议面谁调用鉴权用途
/v3/mock/**通道子应用(主联调链路)RSA 公私钥双向签名 + 防重放(Mock-Sign / Mock-Timestamp / Mock-Nonce)支付、退款、分账、预授权、对账、进件、终端等 21 个网关端点
/mock/ui/api/**管理台页面控制台登录(默认 mock/mock,可关)订单查询、人工裁决、规则配置、造数、重置数据

两类端点的响应都带 Cache-Control: no-store;静态资源不带该头,前面套 CDN 时照常缓存。付款人用的独立页面(收款确认、模拟支付、付款码)依赖的端点匿名放行。

网关只用一套全局密钥对:商户私钥签请求,平台私钥签响应与回调,材料在管理台「系统 → 联调材料」页复制。请求里可以带 key_owner_no,它只是归属标记,验签仍用全局公钥。

数据与容量 ​

  • 全部数据落在 SQLite 单文件(默认 data/mock-channel.db,可用 mock.db-path 改路径),WAL 模式、连接池 2,父目录启动时自动创建;
  • 建表脚本幂等,每次启动执行;订单/规则/回调记录重启不清零;
  • 容量上限可配:支付订单、退款单、分账单各 5000,回调记录 2000,超出按创建时间淘汰最老;
  • 想回到干净状态,删掉 data/mock-channel.db* 三个文件重启即可(回到两套内置种子 + 默认规则);管理台的「清空全部数据」只清交易数据,不动档案与规则。

不连 PostgreSQL、不连 Redis、不连 MQ,因此可以在任何一台开发机上单进程跑起来。

生产防线 ​

生产防线做在主应用侧,不在 mock 侧:

  • daxpay-channel-mock 编排模块挂部署模式条件装配,主应用以 PROD 模式启动时整体不装配(bean 不注册);
  • 此时若路由仍配了 mock 通道商户,下单会直接报「产品策略不存在」,fail-fast 而不是静默成功;
  • 面板的演示模式在切回生产部署时会清理演示容器。

管理台不是「内网就安全」

管理台能做强制改单与补发回调,一旦被外部访问,等于把支付结果的裁决权交出去。部署时只监听内网地址或本机,切勿为了「方便演示」挂到公网域名上。

设计约束 ​

约束原因
单文件存储、零外部依赖联调环境随时起停、随时清空,不占一套中间件
判定链收敛为「默认成功 + 主体覆盖」全局旁路(全部成功/全部失败)容易切了忘切,造成整批静默失败,已下线
规则表只保留分账一张分账是纯查询式、无回调,规则是它唯一的自动判定手段;其余交易靠人工裁决与主体覆盖
回调统一明文单层 JSON + 三签名头便于抓包排障,同时保留验签环节
内置档案结构性锁定种子里两套直连/服务商档案是演示与测试的锚点,禁止删除改名,避免一键演示失效