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() - 不要在
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/") - 命令行启动时漏掉
--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 的自定义查询。
立即学习“Python免费学习笔记（深入）”；
- 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。
