API 测试栈

这个 pack 装了什么

这个包收齐了把 Postman 和 JMeter 从现代工程团队替掉的 六个开源工具。Postman 2023 后涨价 + 强制云同步把不少团队推走；JMeter 还能用但 XML 脚本和 Java-only 生态在 JavaScript 原生方案面前显得难受。pack 把表面分成三个问题：交互探索 / CI 断言 / 压测。

「交互客户端 + CI 跑器 + 压测」三角覆盖完整生命周期。写接口的时候用 Bruno / Hoppscotch 点；CI 里跑 Hurl 验契约没漂；发版前对 staging 跑 k6 / Artillery / Locust。

为什么离开 Postman 和 JMeter

三个推力同时来。Postman 2023 默认云端化 —— collection 同步到他们服务器，分享要账号，免费档缩水。JMeter UX 停留在 2005 —— XML 配置、GUI 优先，没有舒服的脚本故事。CI 要求 diff 可读 —— Postman 导出的 JSON 在 PR 里没法看；Bruno 的 .bru 和 Hurl 的纯文本 diff 干净，reviewer 一眼能看出问题。

迁移之外，这套开源 pack 还多了 Postman 没有的能力：

• 同一个压测在三个引擎里跑做交叉验证（HTTP 重 k6，浏览器流 Artillery，Python 测试组就用 Locust）
• Hurl 文件可以当文档 —— 粘进 runbook，任何会 curl 的工程师都看得懂
• 自建 Hoppscotch 把企业数据留在自己网络 —— Postman 企业版按席位收费

一条命令装齐

# 把整个 pack 装进当前项目
tokrepo install pack/api-testing-stack

# 或只装单个
tokrepo install hurl
tokrepo install k6

TokRepo CLI 写好 Bruno collection 骨架、tests/api/*.hurl 目录、loadtest/ 文件夹（k6 / Artillery / Locust 模板）。每个资产单独带 GitHub Actions 和 GitLab CI 片段。

常见踩坑

• k6 不预热就当生产数据。k6 默认爬升很快，从 1000 VU 起步前 30 秒服务都在填缓存，p99 看起来比真实差。用 stages 加 30-60 秒爬升期。
• Hurl 断言比对 body 文本。断言在 JSON 路径上（jsonpath "$.user.id"），不要比子串。序列化器换空白或 key 顺序时文本比对会假阳性。
• Bruno collection 不分 environments 就分享。Bruno 支持按环境变量；凭据直接写进 .bru 文件就是把密钥泄漏到 git 历史。用 bru env 加 .env.local 模式。
• Locust 单机超高 RPS。Locust GIL 决定单 Python 进程上限大概 1k-2k RPS；用 --master + 多 --worker，或者超过 5k RPS 直接换 k6。
• 只看吞吐忘了 p99。10k RPS p50=20ms 但 p99=8s 没意义。永远导延迟直方图，不能只看均值。

跟其他 pack 的关系

跟 工作流编排 天然搭（用 Inngest / Prefect cron 跑夜间压测），跟 静态站 & 文档生成器 搭（发布跟 Hurl 测试一致的 OpenAPI 文档，文档和测试同源）。要做测试运行的完整可观测，再叠 图表 & 数据可视化 把 k6 CSV 输出渲染进 Apache ECharts 或 Grafana。