Skip to content

压测验收工具:场景与报告 ​

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

内置场景 ​

场景压什么
ping连通性与最小开销基线
pay-barcode付款码被扫下单(最常用的容量场景)
pay-mixed多种支付方式混合下单
refund-flow下单后退款
close-flow下单后关单
gateway网关支付预下单链路
preauth预授权冻结 / 请款 / 解冻
alloc分账
reconcile对账
callback回调链路
soak长稳(低 TPS 长时间)
ramp-to-break阶梯探峰,找崩点

场景写法见场景包目录里的 _common.md。要点:

  • 容量场景不要传 notifyUrl,避免商户通知干扰吞吐口径;
  • 单号统一 PERF-${runTag}-...,金额用整数分;
  • 付款码金额尾号 1 = 即时成功、3 = 处理中(可用于关单演练);
  • 场景 DSL 字段严格,未知字段直接报错;改完用 perfctl scenario list|validate 离线自检。

造数与数据量阶梯 ​

bash
./perfctl.exe datagen --dataset datasets/orders-1m.yaml --yes [--dry-run]
./perfctl.exe clean --tag PERF-1M --yes
./perfctl.exe verify --tag PERF-1M --expected 1000000
  • 造数按依赖顺序 COPY 业务单、资金单、退款单与流水,支持状态分布、金额区间、时间回推;
  • 数据集支持 refs.merchants[] 多商户:按订单行号轮转,同一源订单的各类单据共用同一商户;
  • 清理按 tag 反向删(退款 → 流水 → 资金单 → 业务单);
  • 数据量阶梯用 perfctl ladder --experiment experiments/volume-ladder.yaml --yes,按 10 万 / 100 万 / 500 万逐档造数并跑查询基准。

指标口径 ​

指标说明
延迟客户端直方图(0.5ms~60s 对数桶),输出 p50 / p90 / p95 / p99 / p999 / max
维度run / stage / flow / step / 错误类;另单列签名耗时与可选响应验签耗时
时间序列每秒采样,整体与分步骤各一套
步骤时序steps.jsonl 每行一个 step 的每秒请求数、错误数、p50/p95/p99
资源采样主应用与 mock 的 actuator(CPU / GC / Hikari / Tomcat)、PG 连接与事务、Redis INFO、压测机自身
归因按资源与延迟特征输出 Top 2 嫌疑(CPU/RSA、连接池、Tomcat、Redis、PG、压测机)

三个边界概念:

  • 稳定上限:连续满足 SLA(P99、错误率、背压)的最高 TPS;
  • 崩点:第一个失败档;
  • 推荐容量:稳定上限 × 0.7。

报告与产物 ​

bash
./perfctl.exe report --run run-20261025-153000
./perfctl.exe compare --a run-... --b run-...
./perfctl.exe results prune --keep 20

每次 run 一个目录,report.html 离线自包含,可直接发给验收方。同目录还有:

文件内容
meta.json场景快照、主机核数、mock 配置、压测库基线
steps.jsonl步骤级每秒指标
timeseries.jsonl整体每秒指标
resources.jsonl资源采样
attribution.json归因结果
verify.json响应验签抽样结果

阶梯实验有单独的阶梯报告(perfctl report --ladder ... 或管理台阶梯页打开)。

一致性核对 ​

按步骤路径识别 /unipay/pay、/unipay/gateway/pre-pay、/unipay/refund 的成功请求数,与库内订单、退款数量比对;组合场景同样适用。对不上时先看 verify.json 里的验签抽样,再查 mock 是否按预期返回成功。

常见问题速查 ​

现象处理
体检报 DB-01 database does not exist压测库未创建,按压测库准备建库或改 database.name
体检报 DB-02 配置库与实际连接不一致应用还连着旧库,按目标库重启应用(工具不切库)
体检报 MOCK-03 容量不足模拟联调通道管理台把订单容量调大或设 0
体检报 APP-04 日志 DEBUG改 INFO/WARN 并重启(工具不代改)
WARN 阻止开压确认风险后逐项勾选,或 --accept-warn ID
造数提示 tag 已存在换 tag,或 clean --tag 后重造;续造用 --append
查询基准出现 Seq Scan预期会命中 pay_normal_order 缺 (mch_no, create_time) 索引,报告会标注