Pytest Fixture--params參數

pytest fixture 的 params參數是一個非常實用的功能，它允許你為同一個 fixture 提供多組不同的數據，從而實現測試的參數化（數據驅動）。這樣，依賴該 fixture 的測試用例會自動執行多次，每次使用一組不同的數據。

下面我將詳細解釋其功能、用法，並提供從基礎到進階的實例

1. 🔰 params 參數核心概念

是什麼：params是 @pytest.fixture裝飾器的一個參數，它接收一個可迭代對象（如列表、元組） 。Fixture 函數會為 params中的每個元素執行一次。

如何取值：在 fixture 函數內部，你需要通過 request.param來獲取每一次循環中傳入的參數值 。這裏的 request是一個內置的 fixture，代表 fixture 的調用狀態。

執行次數：如果一個 fixture 定義了 N 組參數，那麼所有依賴此 fixture 的測試用例都會自動執行 N 次

2. 📝 基礎用法與實例

import pytest

# 定義一個參數化的 fixture
@pytest.fixture(params=["蘋果", "香蕉", "橙子"])
def fruit(request):  # 必須傳入 request 對象
    return request.param  # 通過 request.param 獲取當前參數值

def test_fruit(fruit):  # 測試函數接收 fixture 作為參數
    print(f"\n今天吃的水果是：{fruit}")
    assert isinstance(fruit, str)

當你運行這個測試時，輸出會顯示 test_fruit執行了 3 次：

test_example.py::test_fruit[蘋果] 
今天吃的水果是：蘋果
PASSED
test_example.py::test_fruit[香蕉] 
今天吃的水果是：香蕉
PASSED
test_example.py::test_fruit[橙子] 
今天吃的水果是：橙子
PASSED

3. 🧩 傳遞複雜數據

params不僅可以傳遞字符串、數字等簡單數據，還可以傳遞列表、元組、字典等複雜結構，這在測試需要多個輸入值的場景時非常有用

import pytest

# 使用包含字典的列表來傳遞多組相關數據
@pytest.fixture(params=[
    {"username": "john_doe", "password": "123456"},
    {"username": "jane_smith", "password": "abcdef"},
    {"username": "admin", "password": "securePass123"}
])
def user_credentials(request):
    return request.param  # 每次返回一個字典

def test_login(user_credentials):
    # 在測試中，可以直接通過鍵來訪問數據
    username = user_credentials["username"]
    password = user_credentials["password"]
    print(f"\n嘗試登錄，用户名：{username}, 密碼：{password}")
    # 這裏可以編寫實際的登錄斷言邏輯
    assert isinstance(username, str)
    assert isinstance(password, str)
    assert len(password) >= 6  # 示例：簡單檢查密碼長度

4. 🏷️ 使用 ids 參數提高可讀性

當參數是複雜對象（如字典、自定義類）時，pytest 自動生成的測試 ID 可能不易讀懂。你可以使用 ids參數為每組參數設置一個清晰的別名。

ids可以是一個字符串列表，也可以是一個函數

import pytest

def credential_id(param):
    """一個為憑證數據生成易讀ID的函數"""
    return f"用户_{param['username']}"

@pytest.fixture(params=[
    {"username": "john_doe", "password": "123456"},
    {"username": "jane_smith", "password": "abcdef"},
], ids=credential_id)  # 使用函數生成別名
# 或者直接使用字符串列表：ids=['普通用户John', '管理員Jane']
def identified_credentials(request):
    return request.param

def test_with_identified_credentials(identified_credentials):
    print(f"\n測試：{identified_credentials['username']} 的登錄流程")

運行測試時，你會看到類似 test_with_identified_credentials[用户_john_doe]這樣更清晰的測試名。

6. 🔄 動態參數與高級用法

除了在定義時固定參數，還可以將 params與 pytest.mark.parametrize結合，實現更動態的參數傳遞

import pytest

@pytest.fixture
def dynamic_fixture(request):
    # 從 parametrize 標記中接收參數
    data = request.param
    print(f"\nFixtures 接收到數據: {data}")
    return data

# 通過 parametrize 標記將參數動態傳遞給 fixture
@pytest.mark.parametrize('dynamic_fixture', [100, 200], indirect=True)
def test_with_dynamic_fixture(dynamic_fixture):
    assert dynamic_fixture > 50

7. 💡 最佳實踐與注意事項

1. 作用域（Scope）的影響： 記住 params參數化的執行次數會受到 fixture 作用域（scope）的影響 。例如，一個 scope="module"的 fixture 即使有多個 params，在同一模塊中也只會初始化一次，然後被所有測試用例共享，這可能不是你想要的行為。通常，對需要參數化的 fixture 使用默認的 function作用域。

2. 清理資源（Teardown）： 如果 fixture 創建了需要清理的資源（如打開文件、數據庫連接），可以使用 yield而不是 return 。yield語句之前的代碼是設置（setup），之後的代碼是清理（teardown）

@pytest.fixture(params=["smtp.gmail.com", "mail.python.org"])
def smtp_connection(request):
    # Setup: 建立連接
    connection = f"Connection_to_{request.param}"
    print(f"\n建立連接: {connection}")
    yield connection  # 將連接對象傳遞給測試用例
    # Teardown: 關閉連接 (測試執行完後運行)
    print(f"關閉連接: {connection}")

3. 保持測試獨立性： 確保參數化的各組測試之間是獨立的，一組參數的測試結果不應影響另一組。

總結 pytest.fixture的 params參數是實現數據驅動測試的利器。它的核心流程是：定義參數列表 → fixture 通過 request.param依次獲取 → 觸發多次測試執行。掌握了從基礎傳參到使用 ids、pytest.param等高級技巧，就能高效地覆蓋多種測試場景，減少代碼重複。