Pytest参数化fixture未返回浏览器实例，仅返回元组问题排查

问题原因 #

你直接通过@pytest.mark.parametrize给测试类传参数，但未配置indirect=True，导致pytest没有调用你定义的browser_fixture处理参数，而是直接把参数元组赋值给了同名变量，所以setup方法里拿到的是原始参数，而非预期的WebDriver实例。

解决方案 #

下面提供两种可行的实现方式：

方式一：fixture内置参数化（推荐） #

直接在conftest.py的fixture中定义参数组合，无需在测试类上额外添加parametrize：

# conftest.py
import pytest
from selenium import webdriver
from selenium.webdriver.chrome.options import Options

@pytest.fixture(params=[('chrome', False), ('chrome', True)])  # 可添加多组浏览器/模式参数
def browser(request):
    browser_name, headless = request.param
    options = Options()
    
    # 配置无头模式
    if headless:
        options.add_argument("--headless=new")
    
    # 初始化浏览器驱动
    if browser_name == 'chrome':
        driver = webdriver.Chrome(options=options)
    # 可扩展支持Firefox等其他浏览器
    elif browser_name == 'firefox':
        from selenium.webdriver.firefox.options import Options as FirefoxOptions
        ff_options = FirefoxOptions()
        if headless:
            ff_options.add_argument("--headless")
        driver = webdriver.Firefox(options=ff_options)
    else:
        raise ValueError(f"不支持的浏览器类型: {browser_name}")
    
    yield driver
    # 测试结束后关闭浏览器
    driver.quit()

测试类中直接使用该fixture，如需在setup方法中调用，通过request.getfixturevalue获取实例：

# tests/e2e/test_example.py
class TestE2E:
    def setup_method(self, request):
        self.browser = request.getfixturevalue('browser')
    
    def test_homepage_title(self):
        self.browser.get("http://localhost:8000")
        assert "Django" in self.browser.title

方式二：测试类参数化结合indirect=True #

如果需要在测试类层面指定参数，必须添加indirect=True，让pytest将参数传递给fixture处理：

# conftest.py
import pytest
from selenium import webdriver
from selenium.webdriver.chrome.options import Options

@pytest.fixture
def browser(request):
    # 从request获取测试类传入的参数
    browser_name, headless = request.param
    options = Options()
    if headless:
        options.add_argument("--headless=new")
    
    driver = webdriver.Chrome(options=options)
    yield driver
    driver.quit()

测试类定义：

# tests/e2e/test_example.py
import pytest

@pytest.mark.parametrize("browser", [('chrome', False)], indirect=True)
class TestE2E:
    def setup_method(self, request):
        self.browser = request.getfixturevalue('browser')
    
    def test_login_page(self):
        self.browser.get("http://localhost:8000/login/")
        assert "Login" in self.browser.page_source

关键说明 #

• indirect=True是核心：它告诉pytest，这个参数不是直接传递给测试函数，而是要传递给同名的fixture，由fixture处理后返回实例。
• 避免直接在setup方法中访问self.browser（未通过fixture注入时），因为此时它只是原始参数元组，而非WebDriver对象。

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