You need to enable JavaScript to run this app. 如何使用多个locustfile运行Locust测试
优惠活动
大模型
产品
解决方案
定价
更多

如何使用多个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的内容

  • 适合管理分散在不同目录的测试文件,避免每次运行都要在命令行敲一长串文件路径
  • 操作步骤:
    1. 新建一个作为统一入口的主locust文件,例如命名为entry_locust.py
    2. 在主文件顶部导入需要用到的其他测试文件中的任务类,如果测试文件在子目录,要先把对应目录加入Python的系统搜索路径,示例代码:
    import sys
    # 把存放散落在子目录的测试文件的路径加入搜索范围
    sys.path.append("./scenarios")
    # 直接导入其他locustfile中定义的用户类
    from login_tasks import LoginUser
    from order_tasks import OrderUser
    from browse_tasks import GuestUser
    
    1. 运行时只需要指定这个主入口文件即可:locust -f entry_locust.py
  • 优势:调整要运行的测试范围只需要修改主文件里的导入语句,不需要改动固定的运行命令,更适合和CI流水线集成。

方法3:批量自动加载目录下的所有locustfile

  • 适合测试文件数量多、统一存放在专用目录的大规模测试场景
  • 操作步骤:
    1. 把所有需要参与运行的locustfile统一放到一个专用目录,例如命名为all_test_cases
    2. 编写主加载文件,实现自动遍历目录导入所有测试文件内容的逻辑,示例代码:
    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)
    
    1. 运行时指定这个带加载逻辑的主文件即可:locust -f auto_load_entry.py
  • 注意事项:新增或删除测试文件后不需要修改加载脚本,只要文件存在目录里、没有同名用户类冲突,就会被自动加载到Locust的可选类列表里。

内容的提问来源于stack exchange,提问作者Michael George

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.28 17:15:05