本文作者:icy

Golang-Go 版 HttpRunner 介绍

icy 昨天 15 抢沙发
Golang-Go 版 HttpRunner 介绍摘要: Go 版 HttpRunner 介绍 背景 HttpRunner 最早是以 Python 实现的接口自动化测试框架,在社区里积累了大量用户。随着 Go 语言在后端和云原生领域的普及...

Golang-Go 版 HttpRunner 介绍

Go 版 HttpRunner 介绍

背景

HttpRunner 最早是以 Python 实现的接口自动化测试框架,在社区里积累了大量用户。随着 Go 语言在后端和云原生领域的普及,HttpRunner 官方推出了 Go 版本(v4+),用 Go 重写了核心引擎,保留了 YAML/JSON 驱动的测试用例风格,同时带来了更小的体积、更高的并发能力和更好的部署体验。

项目地址:https://github.com/httprunner/httprunner

它是什么

Go 版 HttpRunner 是一个开源、协议无关的接口测试框架,核心特点:

  • 用例即配置:用 YAML/JSON 描述 HTTP(S)、gRPC 等接口的测试步骤、断言、变量、参数化,无需写代码即可完成大部分测试。
  • CLI 优先:一个 hrp 二进制即可完成录制、转换、运行、生成报告、执行性能测试等常用操作。
  • 支持多协议:HTTP(S)、HTTP/2、gRPC、TCP 等(借助插件和扩展)。
  • 支持性能测试:内置基于 boomer 的压测能力(与 Locust 生态兼容)。
  • 工程化友好:单文件可执行,适合接入 CI/CD 与容器化运行。

安装与快速上手

安装

Bash
# macOS / Linux
bash -c "$(curl -ksfL https://raw.githubusercontent.com/httprunner/install/master/install.sh)"
# 或使用 go install
go install github.com/httprunner/httprunner/v4@latest

安装后验证:

Bash
hrp -v

一个最小 HTTP 用例(YAML)

YAML
config:
  name: "demo api test"
  base_url: "https://httpbin.org"
  variables:
    username: "httprunner"

teststeps:
  - name: "get with query"
    request:
      method: GET
      url: "/get"
      params:
        name: $username
    validate:
      - check: status_code
        assert: equals
        expected: 200
      - check: body.args.name
        assert: equals
        expected: "httprunner"

运行:

Bash
hrp run demo.yaml

用参数化做数据驱动:

YAML
config:
  name: "param demo"
  base_url: "https://httpbin.org"
  parameters:
    user: [alice, bob, carol]
teststeps:
  - name: "get /get"
    request:
      method: GET
      url: /get
      params:
        user: $user
    validate:
      - check: body.args.user
        assert: equals
        expected: $user

性能测试

Bash
hrp boom demo.yaml --spawn-count 50 --spawn-rate 5 --run-time 30s

得到与 Locust 类似的结果报表,可无缝接入现有的压测体系。

录制与转换

Bash
# 录制 HTTP 流量生成用例
hrp record --save-tests ./recorded
# 将 HAR 转为测试用例
hrp convert --from-har x.har --to-yaml

典型使用场景

  1. 接口回归测试:YAML 管理用例,接入 CI,运行 hrp run cases/ 即可。
  2. 数据驱动测试:parameters 支持笛卡尔积、CSV 引用等,方便做多组合验证。
  3. 性能压测:用同一份用例做功能与性能双用。
  4. 混沌/混合协议测试:通过插件机制扩展协议(例如 WebSocket、TCP、DNS 等)。

与 Python 版本的关系

维度 Python 版 Go 版(v4+)
运行时 需要 Python 环境 单二进制
性能 中等 更高
生态/插件 最丰富 逐步完善,支持插件
用例 YAML 兼容 是 大体兼容,部分字段有所调整

如果你是存量 Python 用户,迁移时主要注意 teststeps 字段结构(v4 使用 request 而非 api/method 直接平铺)以及断言写法(validate 的 check/assert/expected 结构)。

工程实践建议

  • 目录规范:config/ 放公共变量与 host,testcases/ 放单接口用例,testsuites/ 组合用例。
  • 环境隔离:利用 --venv/ENV 变量或 config 中的 base_url 覆盖,避免硬编码 host。
  • 报告产出:hrp run --gen-html-report 生成 HTML 报告;配合 --save-tests 留存运行产物用于排障。
  • CI 集成:以容器方式运行 httprunner/httprunner:latest,缩短环境准备时间。
  • 断言分层:优先断言 status_code 和关键字段,避免过度耦合响应结构。

总结

Go 版 HttpRunner 把「YAML 描述用例 + 单二进制执行」的组合做得很扎实:既能满足日常接口自动化,也覆盖了压测与多协议扩展,落地成本低。对需要把测试能力嵌入流水线、又不想维护 Python 环境的团队来说,它是一个很值得上手的方案。

httprunner_20261108050953.zip
类型:压缩文件|已下载:0|下载方式:免费下载
立即下载
文章版权及转载声明

作者:icy本文地址:https://www.zelig.cn/golang/1524.html发布于 昨天
文章转载或复制请以超链接形式并注明出处软角落-SoftNook

觉得文章有用就打赏一下文章作者

支付宝扫一扫打赏

微信扫一扫打赏

阅读
分享

发表评论

快捷回复:

评论列表 (暂无评论,15人围观)参与讨论

还没有评论,来说两句吧...