简体中文
模拟联调通道:常见问题与排障
回调没有到主应用
按顺序查三处:主应用「平台配置 → 访问地址」是否配置且从 mock 所在机器可达;订单详情里的回调记录有没有发出、HTTP 状态是什么;主应用有没有把回调地址当成公网域名解析(本机联调需要在 hosts 里指回本机)。
下单报「产品策略不存在」
主应用以 PROD 模式启动时 mock 编排模块整体不装配,路由到 mock 必然报这个错。改为 dev 模式重启,或把该应用路由切到真实通道。
路由候选里没有模拟通道
两种可能:数据集不对(纯净数据集 data.sql 不含 mock 通道主数据,换成 data-demo.sql);或能力主数据缺行,导致保存时的候选校验把该支付方式滤掉了。
确认页打不开 / 手机扫码 404
确认页地址是 mock 服务自己生成的(http://<mock 地址>:10400/#/pay/...)。手机扫到的地址如果指向 127.0.0.1,一定打不开——把 mock 监听到局域网地址,或用电脑打开确认页、手机另行模拟。
规则不生效
判定链是四层:订单手动覆盖 → 商户级 → 服务商级 → 交易类型默认。你改的那条可能被更高层覆盖了。确认主体档案里有没有配过场景覆盖,以及金额尾号是否命中分账规则。
聚合支付推成功被拒(40404)
聚合单推成功必须带实际钱包。确认页点四个钱包按钮之一才会写入 actual_provider;如果是从接口直接推终态,要显式带钱包字段。失败与挂起不要求钱包。
数据不见了 / 想清空重来
全部数据在 data/mock-channel.db(WAL 模式还有 -wal、-shm 两个文件),重启不清零。管理台「清空全部数据」只清订单/退款/分账/回调,档案与规则不动;要连档案一起回到初始态,删掉这三个文件重启,内置种子会重新补齐。
改了管理台界面不生效
生产形态走的是后端 static 目录里的构建产物。改完必须 cd ui && pnpm build 重新生成并提交,否则改动只存在于 dev server(10500)。
模拟通道能启动,但下单没反应
先确认下单确实路由到了 mock:看通道子应用日志有没有出站请求,看 mock 管理台的订单列表有没有新单。有单但状态不动,去看确认页是不是还没点;没单说明路由或通道商户号没配对。
生产环境要不要装
不要。生产部署清单里不放模拟联调通道,主应用侧也不会装配 mock 模块。需要给客户演示时,单独准备一套演示环境,或使用运维面板的演示模式。