locust报错“modulenotfounderror: no module named 'locust'”是因python版本低于3.8、未激活虚拟环境或误装locustio;flask接口404需绑定0.0.0.0并配全host;发json请求须用json=参数;qps低因werkzeug不支持并发,应换gunicorn等wsgi服务器。

Locust安装后运行报错 ModuleNotFoundError: No module named 'locust'
这是 Python 环境没装对,或者用了虚拟环境但没激活。Locust 从 2.0 开始已不再兼容 Python 2,且必须用 pip 安装到当前 Python 解释器环境里。
实操建议:
- 确认 Python 版本 ≥ 3.8:
python --version - 用
pip install locust(不是pip install locustio,后者是旧版) - 如果用虚拟环境,先
source venv/bin/activate(Linux/macOS)或venv\Scripts\activate(Windows),再装 - 验证是否装进当前环境:
python -c "import locust; print(locust.__version__)"
Flask 接口在 Locust 里调不通,返回 404 或连接拒绝
常见原因是 Flask 默认只监听 127.0.0.1:5000,而 Locust 脚本默认也跑在本地,但可能因 host 配置、调试模式或端口冲突导致请求发不到。
实操建议:
- 启动 Flask 时显式绑定地址:
app.run(host='0.0.0.0', port=5000)(仅开发用,别在生产环境这么干) - 检查 Flask 是否启用了调试模式(
debug=True),某些情况下会干扰长连接,压测前设为False - Locust 脚本中
host参数要写全,比如host="http://127.0.0.1:5000",不能只写"localhost"(DNS 解析可能失败) - 用
curl http://127.0.0.1:5000/your-endpoint先手动验证接口可达
Locust 脚本里怎么发带 JSON 的 POST 请求
Flask 接口常接收 application/json,但 Locust 默认不设 Content-Type,也不自动序列化 body,直接传 dict 会 400。
图片提示词生成器?不止如此。 马甲系统 —— 把脑海中的画面,翻译成AI能理解的专业表达。 用得越多,它越懂你:首次需要多问几句确认方向,用久了几乎一说就懂。 用得越多,它越快:缓存机制让后续对话越来越省。 RAG进化:成功案例持续入库,越跑越聪明。 输入「新手指南」查看完整功能介绍
实操建议:
- 用
self.client.post("/api/login", json={"username": "test", "password": "123"})——json=参数会自动序列化 + 设 header - 如果要用
data=手动传,得自己import json,然后data=json.dumps({...})+ 显式加 header:headers={"Content-Type": "application/json"} - 注意 Flask 端用
request.get_json()取值,别用request.form - 如果接口需要 token 或 cookie,记得在
on_start里登录一次并保存 session
压测时 QPS 上不去,CPU 占用低但响应延迟飙升
这不是 Locust 不行,而是 Flask 默认的 Werkzeug 开发服务器单线程 + 单进程,根本扛不住并发。它只适合调试,不是 Web 服务器。
实操建议:
- 压测前必须换 WSGI 服务器:推荐
gunicorn(简单)或uWSGI(灵活) - 用 gunicorn 启动:
gunicorn -w 4 -b 127.0.0.1:5000 app:app(4 个工作进程) - Locust 脚本里的
host改成"http://127.0.0.1:5000",指向 gunicorn 端口 - 观察 gunicorn 日志是否有 worker timeout 或重启,适当调大
--timeout和--keep-alive
真正卡住的地方往往不在代码逻辑,而在 Flask 默认服务器的线程模型和你没意识到它根本不该出现在压测链路里。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










