如何在单个pytest测试文件中调用多个API模块？

方案1：参数化fixture，动态指定API模块 #

• 改造根目录conftest.py中的api fixture，让它接受参数（如api_module），不再绑定固定的module fixture
• 示例代码：

# 根目录conftest.py
import pytest

@pytest.fixture
def api(request, config, api_client):
    module_name = request.param
    # 导入目标API模块
    api_module = __import__(f"your_api_package.{module_name}", fromlist=[""])
    # 初始化并返回API实例
    return api_module.ApiClass(api_client, config)

• 测试用例中，可通过@pytest.mark.parametrize批量指定模块，或用request.getfixturevalue调用不同参数的api fixture

方案2：为每个API模块创建专用fixture #

• 在对应API目录的conftest.py中，为需要同时使用的模块分别定义独立fixture
• 示例代码：

# API目录下的conftest.py
@pytest.fixture
def battery_api(config, api_client):
    import your_api_package.battery_api as module
    return module.BatteryApi(api_client, config)

@pytest.fixture
def battery_managing_api(config, api_client):
    import your_api_package.battery_managing_api as module
    return module.BatteryManagingApi(api_client, config)

• 测试用例直接注入多个fixture即可：

def test_battery_lifecycle(battery_api, battery_managing_api):
    # 用battery_api查询电池信息
    target_battery = battery_api.get_battery_by_id(101)
    # 用battery_managing_api更新电池状态
    battery_managing_api.set_battery_status(101, "in_use")
    # 断言状态更新成功
    updated_battery = battery_api.get_battery_by_id(101)
    assert updated_battery.status == "in_use"

方案3：改造现有module fixture为可参数化形式 #

• 保留api fixture的原有依赖逻辑，让module fixture支持参数化或动态指定
• 示例代码：

# 测试文件内的局部fixture定义
@pytest.fixture(params=["battery_api", "battery_managing_api"])
def module(request):
    return request.param

# 测试用例中动态切换模块
def test_multi_api_operation(request, config, api_client):
    # 初始化BatteryApi
    request.node.funcargs["module"] = "battery_api"
    battery_api = request.getfixturevalue("api")
    # 初始化BatteryManagingApi
    request.node.funcargs["module"] = "battery_managing_api"
    battery_managing_api = request.getfixturevalue("api")
    
    # 执行跨API的测试逻辑
    battery_managing_api.create_battery("test_battery")
    new_battery = battery_api.get_battery_by_name("test_battery")
    assert new_battery is not None

方案推荐 #

优先选择方案2，这种模式逻辑清晰，每个API模块对应独立fixture，测试用例可读性强，后续维护成本低，完全契合pytest的fixture设计思路。如果多个API的初始化逻辑重复，可以抽离一个通用工具函数，在各个API fixture中调用以减少冗余代码。

内容的提问来源于stack exchange，提问作者Ariel Agranovich