如何使用多个locustfile运行Locust测试
多Locust测试文件(locustfile)运行的实操方法
以下都是经过实际验证可直接落地的操作步骤,没有模糊的概念性描述
方法1:通过命令行直接指定多个文件路径
- 运行命令的标准格式为:
locust -f 文件1路径.py,文件2路径.py,文件3路径.py - 关键注意事项:
- 多个文件路径之间必须用不带空格的英文逗号分隔,写成
locust -f a.py,b.py是有效的;如果加了空格比如locust -f a.py, b.py,会把空格开头的b.py识别为独立的路径参数,触发文件找不到的报错 - 带子目录的文件直接填写相对/绝对路径即可,例如
locust -f common/auth_api.py,scenarios/login_flow.py - 启动Locust的WebUI后,下拉选择用户类的菜单里,会自动加载所有指定文件内定义的Locust任务类
- 多个文件路径之间必须用不带空格的英文逗号分隔,写成
- 常见踩坑:如果不同文件里定义了同名的用户类,排在命令行参数越靠后的文件里的同名类优先级越高,会完全覆盖前面文件的同名类,不会实现同时加载,写测试时要给不同场景的用户类设置唯一命名,避免非预期的覆盖。
方法2:通过主入口文件导入其他locustfile的内容
- 适合管理分散在不同目录的测试文件,避免每次运行都要在命令行敲一长串文件路径
- 操作步骤:
- 新建一个作为统一入口的主locust文件,例如命名为
entry_locust.py - 在主文件顶部导入需要用到的其他测试文件中的任务类,如果测试文件在子目录,要先把对应目录加入Python的系统搜索路径,示例代码:
import sys # 把存放散落在子目录的测试文件的路径加入搜索范围 sys.path.append("./scenarios") # 直接导入其他locustfile中定义的用户类 from login_tasks import LoginUser from order_tasks import OrderUser from browse_tasks import GuestUser- 运行时只需要指定这个主入口文件即可:
locust -f entry_locust.py
- 新建一个作为统一入口的主locust文件,例如命名为
- 优势:调整要运行的测试范围只需要修改主文件里的导入语句,不需要改动固定的运行命令,更适合和CI流水线集成。
方法3:批量自动加载目录下的所有locustfile
- 适合测试文件数量多、统一存放在专用目录的大规模测试场景
- 操作步骤:
- 把所有需要参与运行的locustfile统一放到一个专用目录,例如命名为
all_test_cases - 编写主加载文件,实现自动遍历目录导入所有测试文件内容的逻辑,示例代码:
import sys import importlib import pathlib # 将测试文件目录加入Python搜索路径 test_case_dir = pathlib.Path("./all_test_cases").resolve() sys.path.append(str(test_case_dir)) # 遍历目录下所有py文件,跳过带__开头的系统特殊文件 for py_file in test_case_dir.glob("*.py"): if py_file.name.startswith("__"): continue # 动态导入每个测试模块 module_name = py_file.stem importlib.import_module(module_name)- 运行时指定这个带加载逻辑的主文件即可:
locust -f auto_load_entry.py
- 把所有需要参与运行的locustfile统一放到一个专用目录,例如命名为
- 注意事项:新增或删除测试文件后不需要修改加载脚本,只要文件存在目录里、没有同名用户类冲突,就会被自动加载到Locust的可选类列表里。
内容的提问来源于stack exchange,提问作者Michael George
相关产品推荐
相关产品推荐

