Locust安装与基础配置需注意:Python 3.8+为硬性要求;Windows下conda环境应使用conda install -c conda-forge locust避免pyzmq编译失败;须验证locust --version输出;配置文件需显式指定--config=locust.conf;推荐使用HttpUser类并设置timeout及User-Agent;分布式模式下master需绑定0.0.0.0且开放5557/5558端口;高并发时需调高ulimit并考虑多进程或多机worker。

Locust安装与基础配置要注意什么
Locust不是pip install locust就能直接跑通的。Python 3.8+是硬性要求,低于3.7会报ModuleNotFoundError: No module named 'asyncio';Windows用户如果用conda环境,得先conda install -c conda-forge locust,否则可能因pyzmq编译失败卡在启动阶段。
- 确保
locust命令能执行:运行locust --version看到输出才算装对 - 配置文件默认不加载,想用
locust.conf需显式加--config=locust.conf -
LOCUSTFILE环境变量可指定脚本路径,避免每次敲-f xxx.py
如何写一个能发真实HTTP请求的User类
HttpUser才是发请求的主力,别用过时的Locust基类。它自带self.client(本质是requests.Session),但默认不带User-Agent,某些网站会直接返回403。
- 登录态必须手动维护:调用
self.client.post("/login", json={"u": "a", "p": "b"})后,后续请求自动携带Set-Cookie头 - 请求超时要设:不加
timeout=10参数,慢接口会让整个worker卡住,压测数据失真 - 避免在
on_start里做耗时操作(比如读大文件),它会在每个虚拟用户启动时执行,拖慢整体并发初始化
示例片段:
from locust import HttpUser, task, between
<p>class ApiUser(HttpUser):
wait_time = between(1, 3)</p><pre class="brush:php;toolbar:false;">def on_start(self):
self.client.post("/auth/login", json={"username": "test", "password": "123"})
@task
def get_list(self):
self.client.get("/api/items", timeout=5)分布式模式下常见连接失败怎么排查
locust -f script.py --master和--worker分开跑时,worker连不上master是最高频问题。根本原因通常是网络隔离或端口未开放,而非代码错误。
- master默认只监听
127.0.0.1:5557,worker在另一台机器上就必然连不上——必须加--master-bind-host=0.0.0.0 - 防火墙常拦截
5557(master通信)和5558(web UI),Linux用sudo ufw allow 5557,云服务器还要配安全组 - worker启动后没出现在master页面?检查日志里有没有
Failed to connect to master,有就说明网络层不通,不用查Python逻辑
压测结果里响应时间突增但错误率很低,可能是什么原因
这通常不是服务端崩了,而是Locust自身资源瓶颈。尤其当--users设到5000+、单机跑worker时,Python GIL和系统文件描述符限制会先于目标服务拖垮测试。
- Linux默认
ulimit -n是1024,压测中每个TCP连接占一个fd,很快打满,现象是大量ConnectionRefusedError或请求卡在pending状态 - 检查
top里locust进程CPU是否长期100%,是的话说明单核跑满,得加--processes启多进程(注意:非多线程) - 更隐蔽的是DNS缓存:频繁请求不同子域时,没配
resolve_hostnames=False会导致每秒上百次DNS查询,把worker拖慢
真实场景里,宁愿多起几台低配worker,也不要在一台机器上硬扛5000+ users。Locust的分布式设计,本来就是为横向扩展准备的。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











