locust运行报错“modulenotfounderror: no module named 'locust'”主因是安装环境错配,需确认激活对应django虚拟环境并用对应python执行pip install;locustfile.py须手动配置django环境(os.environ.setdefault+django.setup);任务类必须继承httpuser且含@task方法;启动必须指定--host指向django服务地址。

Locust 安装后运行报错 ModuleNotFoundError: No module named 'locust'
这是最常见的环境问题:Python 找不到 locust 模块,不是没装,而是装错了 Python 环境。Django 项目通常用虚拟环境,但你可能在系统 Python 或另一个 venv 里 pip install 了 locust。
- 确认当前终端激活的是 Django 项目用的虚拟环境(比如
source venv/bin/activate) - 运行
which python和python -m pip list | grep locust,确保locust出现在输出里 - 别用
pip3 install locust—— 如果python指向的是 Python 3.9,而pip3装到了 3.11 的 site-packages,就对不上 - Mac M1/M2 用户注意:如果用 conda,
conda install -c conda-forge locust更稳,避免 arm64 编译问题
写 locustfile.py 时怎么调用 Django 视图或 ORM
Locust 是独立进程,不自动加载 Django 环境。直接 import models 或调用 reverse() 会报 DjangoSettingsNotConfigured。
- 必须在
locustfile.py开头手动配置 Django:import os import django from django.conf import settings <p>os.environ.setdefault("DJANGO_SETTINGS_MODULE", "myproject.settings") django.setup()</p> - 不要在
on_start()里做django.setup()—— 每个用户实例都会重复执行,引发 RuntimeError - ORM 查询尽量用
.values_list('id', flat=True)而非全量对象,避免内存暴涨;高并发下Model.objects.get()容易触发数据库连接池耗尽 - 如果只是压测 HTTP 接口(推荐),就别碰 ORM —— 直接用
self.client.get("/api/user/"),更真实,也避开事务和中间件干扰
启动 Locust 后 UI 打不开或显示 0 用户
页面能打开但“Start swarming”按钮点不动、数字不涨,大概率是任务类没继承正确,或用户数/孵化率设得太低。
- 类必须继承
HttpUser(不是User),且至少定义一个带@task装饰的方法:from locust import HttpUser, task <p>class ApiUser(HttpUser): @task def get_user_list(self): self.client.get("/api/users/")</p> - 命令行启动时漏掉
--host:必须显式指定,例如locust -f locustfile.py --host http://localhost:8000,否则self.client默认发请求到http://127.0.0.1:8089(Locust 自己的端口) - 浏览器访问的是
http://localhost:8089,但 Django 正在跑runserver的端口是8000—— 这俩端口不能混,UI 和被测服务完全分离 - Chrome 120+ 对 localhost 的 CORS 限制变严,若压测接口返回 400/500 却没日志,试试加
--web-insecure启动参数
压测中数据库连接池打满、响应延迟飙升
这不是 Locust 的问题,是 Django + 数据库的协同瓶颈。尤其常见于使用 django.db.connection 或未关闭 cursor 的自定义查询。
- Django 默认数据库连接池大小为 0(无池),高并发下每请求新建连接,MySQL 默认最大连接数才 151 —— 很快就卡住
- 在
settings.py加上连接池配置:DATABASES = { 'default': { 'ENGINE': 'django.db.backends.postgresql', 'CONN_MAX_AGE': 0, # 关键:禁用持久连接,让连接在请求结束时释放 'OPTIONS': { 'MAX_CONNS': 20, 'MIN_CONNS': 5, } } } - 避免在
tasks中用transaction.atomic()包裹长操作 —— 锁表时间拉长,后续请求排队 - 用
locust --headless -u 100 -r 10(100 用户、每秒启 10 个)比一次性拉满更利于定位拐点
真正难调的不是 Locust 参数,而是 Django 日志级别和数据库 slow query log 是否开着——没它们,你根本分不清延迟是卡在视图、序列化、还是 DB round-trip。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











