如何在Debian上使用JMeter进行接口测试

在 Debian 上使用 JMeter 进行接口测试

一 环境准备

• 安装 Java 11（推荐）并验证版本：
  • 安装：sudo apt-get update && sudo apt-get install -y openjdk-11-jdk
  • 验证：java -version、javac -version
• 安装 JMeter（两种常用方式）
  • 方式 A（推荐，便于多版本管理）：下载官方二进制包并解压
    • 下载：wget https://dlcdn.apache.org//jmeter/binaries/apache-jmeter-5.4.3.tgz
    • 解压：tar -xzf apache-jmeter-5.4.3.tgz && cd apache-jmeter-5.4.3
    • 运行 GUI：./bin/jmeter.sh（无图形界面可用 xvfb-run ./bin/jmeter.sh）
  • 方式 B（使用系统仓库）：sudo apt-get install -y jmeter（版本可能较旧，适合快速试用）

二 创建第一个接口测试

• 新建测试计划 → 添加线程组（用于并发与循环控制）
• 添加配置元件
  • HTTP 请求默认值：填入协议（http/https）、服务器/IP、端口，后续请求可省略重复配置
  • HTTP 信息头管理器：如 Content-Type: application/json（JSON 接口必需）
• 添加取样器
  • HTTP 请求：选择方法（GET/POST 等）、路径；GET 在“参数”填键值对，POST 在“Body Data”填 JSON（注意 JSON 格式正确）
• 添加断言
  • 响应断言或JSON 断言：校验状态码、响应体包含/匹配规则等
• 添加监听器
  • 察看结果树（调试用，查看请求/响应详情）
  • 聚合报告（统计：样本数、平均/最小/最大响应时间、错误率、吞吐量等）
• 运行与验证：点击启动，查看监听器结果，确保通过断言且响应符合预期

三 常见问题与实用配置

• 中文乱码
  • 编辑 bin/jmeter.properties：Sampleresult.default.encoding=UTF-8，重启 JMeter
• 命令行无界面运行（CI/服务器推荐）
  • 示例：jmeter -n -t test_plan.jmx -l results.jtl -e -o report/
  • 说明：-n 非 GUI、-t 指定脚本、-l 保存结果、-e -o 生成 HTML 报告
• 远程/分布式执行（多机压测）
  • 在所有 Agent 上：jmeter-server（若报 RMI SSL 相关错误，可在 jmeter.properties 中设置 server.rmi.ssl.disable=true）
  • 在 Controller 上：配置 remote_hosts=agent1:1099,agent2:1099，执行：jmeter -n -t test_plan.jmx -R agent1,agent2 -l remote_results.jtl
• 版本与脚本兼容
  • 避免用高版本 JMeter 保存的 .jmx 在低版本打开；跨平台编辑时尽量使用 UTF-8 避免中文乱码与解析问题

四 快速示例脚本

• 目标：对本地 HTTP 服务 http://localhost:8080/api/hello 发起 GET，校验返回体包含 “hello”
• 步骤
  • 线程组：保持默认（1 线程、1 循环）
  • HTTP 请求默认值：协议 http、服务器 localhost、端口 8080
  • HTTP 请求：方法 GET、路径 /api/hello
  • 断言：添加响应断言，字段“响应文本”，勾选“包含”，匹配内容填 hello
  • 监听器：添加察看结果树与聚合报告
  • 运行：查看结果树通过断言；聚合报告查看响应时间与成功率
• 命令行执行与报告
  • 保存为 hello.jmx 后执行：jmeter -n -t hello.jmx -l hello.jtl -e -o hello_report/
  • 打开 hello_report/index.html 查看图表化报告