本文介绍一种符合 pytest 设计哲学的解决方案：通过间接参数化（indirect=true）结合依赖 fixture 的参数生成 fixture，实现在 @pytest.mark.parametrize 中安全、可维护地复用模块级 fixture（如 time_period）的运行时值。
本文介绍一种符合 pytest 设计哲学的解决方案：通过间接参数化（indirect=true）结合依赖 fixture 的参数生成 fixture，实现在 @pytest.mark.parametrize 中安全、可维护地复用模块级 fixture（如 time_period）的运行时值。
在 pytest 中，@pytest.mark.parametrize 的参数列表在测试收集阶段（collection phase） 就被静态解析，而 fixture（如 time_period）则在测试执行阶段（execution phase） 才被实例化。因此，直接在 parametrize 的参数列表中引用 fixture（如 time_period.start）会导致 NameError 或 FixtureLookupError —— 这是 pytest 的核心机制限制，而非使用错误。
最推荐、最符合 pytest 惯例的解法是：将参数逻辑封装为一个新 fixture，并通过 indirect=True 让 parametrize 触发该 fixture 的调用。该 fixture 可以自由依赖其他 fixture（如 time_period），并利用 request.param 接收外部传入的配置元组，从而动态计算出每次测试所需的参数值。
以下是一个生产就绪的实现示例：
import pytest
from datetime import datetime
from dateutil.relativedelta import relativedelta
from functools import reduce
from operator import add, sub
@pytest.fixture()
def time_horizon(time_period, request):
"""
动态生成 (date_from, date_to) 元组。
依赖 time_period fixture，并通过 request.param 控制计算逻辑。
"""
# 解构参数：(基准属性名, 运算符, date_from 偏移量, date_to 偏移量)
attr_name, op, offset_from, offset_to = request.param
# 获取 time_period 的对应属性（如 start 或 end）
base_dt = getattr(time_period, attr_name)
# 应用偏移：例如 time_period.start - relativedelta(days=4)
date_from = op(base_dt, relativedelta(**offset_from))
date_to = op(base_dt, relativedelta(**offset_to))
return (date_from, date_to)
# 使用 indirect=True 将 'time_horizon' 参数绑定到同名 fixture
# 每个元组代表一组边界测试场景：
# - 场景1：基于 time_period.start 向前偏移（早于有效区间）
# - 场景2：基于 time_period.end 向后偏移（晚于有效区间）
@pytest.mark.parametrize(
"time_horizon",
[
("start", sub, {"days": 4}, {"days": 2}), # (start-4d, start-2d)
("end", add, {"days": 4}, {"days": 2}), # (end+4d, end+2d)
],
indirect=True # 关键：启用间接参数化
)
def test_filter_data_by_time_horizon(time_horizon, factory):
date_from, date_to = time_horizon
# 构造测试数据：确保所有记录均落在过滤窗口之外
test_df = factory_batch_to_dataframe(
factory.create_batch(
size=2,
date_from=date_from,
date_to=date_to,
)
)
# 执行被测函数
filtered_df = filter_data_by_time_horizon(test_df)
# 验证：应无任何记录保留
assert filtered_df.count() == 0✅ 优势说明：
- 解耦清晰：参数定义（parametrize）与参数计算（time_horizon fixture）分离，便于复用和单元测试；
- 作用域安全：time_period 在 fixture 内被正常解析，完全支持 module、session 等任意作用域；
- 可扩展性强：新增测试场景只需在 parametrize 列表中追加元组，无需修改逻辑；
- 调试友好：可在 time_horizon fixture 中添加日志或断点，直观查看每次生成的 (date_from, date_to) 值。
⚠️ 注意事项：
- indirect=True 必须显式声明，且 parametrize 的参数名需与 fixture 名完全一致；
- request.param 是 pytest 提供的特殊 fixture，仅在被 indirect 调用的 fixture 中可用；
- 若 time_period 本身依赖其他 fixture（如数据库连接），该方案仍能自动处理依赖链，无需额外干预；
- 避免在 parametrize 中硬编码日期（如 datetime(2023,1,1)），否则会丧失 fixture 带来的环境隔离性与可配置性。
综上，这种“fixture 驱动参数化”模式是 pytest 官方推荐的最佳实践，既保持了测试的声明式表达力，又严格遵循了 fixture 的生命周期约束，是构建高可靠性数据管道测试的坚实基础。
