在 Debian 上使用 JMeter 进行接口测试
一 环境准备
- 安装 Java 8+（JMeter 5.x 需要 Java 8 及以上）。在终端执行：
- sudo apt update
- sudo apt install openjdk-11-jdk
- java -version 验证版本
- 安装 JMeter（两种常用方式）
- 方式 A（推荐，便于多版本管理）：从官网下载二进制包 apache-jmeter-x.x.x.tgz，解压后运行：
- tar -xzf apache-jmeter-x.x.x.tgz
- cd apache-jmeter-x.x.x/bin
- ./jmeter.sh（GUI）；命令行可用：./jmeter -n -t your_plan.jmx -l result.jtl
- 方式 B（系统仓库）：sudo apt install jmeter（版本可能较旧，适合快速试用）
二 快速上手一个 HTTP 接口测试
- 新建测试计划：打开 JMeter → Test Plan（可重命名）
- 添加线程组：Test Plan → Add → Threads (Users) → Thread Group
- 线程数：1（功能/接口测试常用 1 个线程）
- Ramp-Up：1 秒
- 循环次数：按用例数量设置或勾选 Forever（配合调度器/手动停止）
- 添加配置元件（提升复用性）
- HTTP 请求默认值：协议（http/https）、服务器名称或 IP、端口
- HTTP 信息头管理器：如 Content-Type: application/json（POST/PUT JSON 必填）
- 添加取样器：Thread Group → Add → Sampler → HTTP Request
- 方法：GET/POST 等
- 路径：/api/xxx
- 参数：Query 参数用 Parameters；JSON 用 Body Data
- 添加断言：HTTP Request → Add → Assertions
- 响应断言：检查响应码（如 200）或响应文本
- JSON 断言：校验 JSON Path 与值（如 $.code == 200）
- 添加监听器：Thread Group → Add → Listener
- 查看结果树（View Results Tree）：逐请求查看请求/响应
- 聚合报告（Summary Report）/图形结果：查看 平均响应时间、90% Line、吞吐量、错误率
- 运行与验证：点击绿色启动按钮，查看监听器结果，失败用例在“查看结果树”中定位
三 常用场景与配置要点
- GET 请求：在 HTTP Request 的 Parameters 填写键值对；路径含查询串时可放在 Path 或 Parameters
- POST 请求（JSON）：
- 在 HTTP Header Manager 设置 Content-Type: application/json
- 在 HTTP Request 选择 Body Data，填入 JSON；中文内容建议统一 UTF-8
- 参数化（多账号/数据驱动）：
- 使用 CSV Data Set Config 读取 CSV（配置文件名、变量名、分隔符、是否循环）
- 在请求中通过 ${变量名} 引用
- 关联与提取（后置处理器）：
- 常用 JSON Extractor / 正则表达式提取器 获取 token/sessionId，供后续请求使用
- 结果分析与报告：
- 聚合报告关注：Average、Median、90% Line、Throughput、Error %
- 生成 HTML 报告：命令行执行 ./jmeter -n -t your_plan.jmx -l result.jtl -e -o report
四 命令行非 GUI 运行与报告
- 非 GUI 执行（适合服务器/CI）：
- 执行：./jmeter -n -t your_plan.jmx -l result.jtl
- 生成 HTML 仪表盘：./jmeter -n -t your_plan.jmx -l result.jtl -e -o report
- 常用参数
- -n：非 GUI 模式
- -t：指定 .jmx 脚本
- -l：保存结果到 .jtl
- -e：测试结束后生成报告
- -o：指定报告输出目录（必须为空目录）
- 说明：GUI 仅用于调试与脚本编写，压测/批量执行建议使用非 GUI
五 分布式压测与常见问题
- 分布式压测（Controller/Agent）
- 在所有 Agent 上：编辑 jmeter.properties，设置 server.rmi.ssl.disable=true，启动 ./jmeter-server
- 在 Controller 上：编辑 jmeter.properties，设置 remote_hosts=agent1:1099,agent2:1099
- 执行：./jmeter -n -t your_plan.jmx -R agent1,agent2 -l result.jtl
- 常见问题
- 中文乱码：HTTP 请求中设置 内容编码：UTF-8
- 版本不一致：Windows 编辑的 .jmx 在 Linux 上运行报错，建议统一 JMeter 版本
- 仓库版本过旧：如需新特性/插件，优先使用官网二进制包解压方式