简体中文
模拟联调通道:设计架构
这一页讲四件事:这条链路由哪几个进程组成、请求怎么走、对外暴露哪两类协议面、数据存在哪里。不涉及代码结构和类设计。
组件边界
模拟联调通道不直接面对主应用,而是站在通道子应用身后,扮演「三方支付平台」这一角色:
| 角色 | 职责 | 不做什么 |
|---|---|---|
| 主应用 | 装配 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 + 三签名头 | 便于抓包排障,同时保留验签环节 |
| 内置档案结构性锁定 | 种子里两套直连/服务商档案是演示与测试的锚点,禁止删除改名,避免一键演示失效 |