k6 负载测试快速上手5 步从安装到阈值判定与结果导出的完整指南【免费下载链接】k6A modern load testing tool, using Go and JavaScript项目地址: https://gitcode.com/GitHub_Trending/k6/k6k6 是一款用 Go 编写的负载测试工具测试脚本用 JavaScript 编写可以直接在本机发起压测并按你写的阈值自动判定结果。这篇 k6 使用教程带你走完整流程验证安装、压测自己的本地服务、用阈值让结果自动过线、导出指标最后给出常见报错对照和源码入口。先装好 k6 并确认能跑k6 安装只有两条路选一条即可预编译二进制到发行版页面下载与你操作系统、CPU 架构匹配的二进制包解压后把k6放进PATH不用装 Go。源码构建执行git clone https://gitcode.com/GitHub_Trending/k6/k6进入仓库运行make build等价于go build产物就是当前目录下的k6可执行文件。验证出口✅ 执行k6 version能打印出版本号后续步骤都依赖它。最小 k6 脚本长什么样一个 k6 脚本必须导出两个东西default函数一个虚拟用户VU的一轮行为发请求、做断言。options对象声明并发多少、压多久、用什么指标验收。import http from k6/http; import { check } from k6; export const options { stages: [ { duration: 20s, target: 5 }, { duration: 20s, target: 0 }, ], }; export default function () { const r http.get(http://localhost:8080/); check(r, { 状态码是 200: (x) x.status 200 }); }保存为script.js。target是该阶段结束时要达到的并发用户数duration是持续时长。准备一个本地目标起任意 HTTP 服务例如在 8080 端口监听并逐条应答while true; do echo {ok:true}; sleep 0.2; done | nc -l 8080跑起来看哪里算成功执行k6 run script.js。期间终端实时滚动vus、iter、http_reqs等指标结束时打印一张汇总表。只确认三处看哪里期望值不满足时先查什么http_reqs的req/s与http_req_failed大于 0失败率 0.00%本地服务是否真的在监听iterations大于 0目标地址拼写checks通过率100.00%接口返回是否真的 200如果http_reqs恒为 0先用curl http://localhost:8080确认服务可达再看终端有没有打印连接错误。k6 阈值配置跑完自动判定还能导出结果把验收线写进脚本给options加一个thresholds字段。每条是指标名: 表达式http_req_duration: [p(99)200]p99 延迟99% 的请求延迟低于该值不超过 200 毫秒。http_req_failed: [rate0.01]请求失败率低于 1%。加完后重跑。看汇总表里的 thresholds 区域每行显示 PASS 或 FAIL。退出码随判定联动——全过返回 0任一 FAIL 返回非 0这正是把 k6 接进 CI 的原因。验证链路是否真通临时把 p99 上限改成11 毫秒再跑一次阈值行应变为 FAIL、退出码变非 0。导出指标存档跑的时候追加一个参数原始样本会逐条写进文件k6 run --out jsonrun.json script.js跑完看run.json每行一条 JSON带指标名、值和时间戳可直接接分析工具或监控系统。换协议压测复用现成脚本改地址仓库 examples/ 目录按协议备好了可改即用的 k6 脚本examples/websockets/ws.js测 WebSocket把服务地址换成你自己的。examples/grpc_healthcheck.js测 gRPC配合 examples/grpc_server/ 里的示例服务端启动后可直接压。examples/thresholds.js、examples/stages.js阈值与阶段配置的更多写法。每个文件顶部几行就是场景声明改地址、改并发即可。想读实现入口在下一节。四个高频报错对照脚本报SyntaxError或default is not a function多半是 import 拼错模块名是k6/http而不是http或default没导出成函数。http_reqs恒为 0或全是 connection refused先curl目标地址再检查本机代理变量与 hosts 配置k6 默认走系统代理本地回环常被代理拦掉。改了options行为没变⚠️ 字段名拼错时 k6 静默回退默认值。跑k6 inspect script.js核对实际解析出的 VU、时长与阈值。内网服务压出来很慢生产却正常先确认压测机与服务的位置关系排除跨网段、跨代理链路本机带宽与 DNS 也可能先被打满。k6 命令速查4 条最高频操作k6 run script.js发起完整负载测试。k6 inspect script.js不执行直接打印解析出的执行配置排查 options 拼错的标配动作。k6 run --vus 10 --duration 30s script.js命令行覆盖脚本里的并发数与时长。k6 run --out jsonrun.json script.js原始指标逐条写入文件。k6 version/make build确认版本、从源码构建。继续深挖的三个入口设计文档与特性说明docs/更多现成脚本examples/负载调度源码lib/executor/ramping 逻辑在ramping_vus.go阈值解析metrics/thresholds.go【免费下载链接】k6A modern load testing tool, using Go and JavaScript项目地址: https://gitcode.com/GitHub_Trending/k6/k6创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考