根本原因是python 3.10+中functools.wraps行为变化与pytest装饰器叠加，导致测试函数__name__和__qualname__在收集阶段被意外修改，使pytest无法正确定位和报告测试。
pytest 3.10+ 中 @pytest.mark.parametrize 装饰器导致测试函数名被覆盖
根本原因不是 pytest “无法识别”，而是装饰器（尤其是 @pytest.mark.parametrize）在 Python 3.10+ 中与 functools.wraps 的行为变化叠加后，导致 test_func.__name__ 和 test_func.__qualname__ 在收集阶段被意外修改，pytest 依赖这些属性定位和报告测试，一旦出错就表现为“找不到测试”或“跳过未注册的函数”。
典型现象包括：pytest 运行后显示 0 passed, 0 failed, 0 skipped，但实际存在带 @pytest.mark.parametrize 的测试；或者报错 ValueError: no such test；又或者 IDE（如 PyCharm）里测试函数不显示为可运行项。
- Python 3.10 引入了 PEP 614，放宽了装饰器语法限制，但更关键的是 CPython 对
functools.wraps底层实现做了优化，对__wrapped__链和__qualname__的继承逻辑更严格 - 旧版
pytest（ - 升级到
pytest>=6.2.5可解决绝大多数情况 —— 它重写了测试收集逻辑，改用inspect.signature+ 显式__pytest_wrapped__属性定位原始函数
自定义装饰器导致 pytest 收集失败的常见写法
如果你写了类似 @my_test_setup 的装饰器并用于测试函数，却在 pytest 3.10+ 下失效，大概率是没正确调用 functools.wraps 或漏传了关键属性。
错误示例：
def my_test_setup(func):
def wrapper(*args, **kwargs):
setup()
return func(*args, **kwargs)
return wrapper # ❌ 没用 @wraps，__name__ 变成 'wrapper'
正确做法必须显式保留原始函数元信息：
from functools import wraps <p>def my_test_setup(func): @wraps(func) # ✅ 必须加这行 def wrapper(*args, *<em>kwargs): setup() return func(</em>args, **kwargs) return wrapper </p>
- 仅
@wraps(func)不够：某些 pytest 插件（如pytest-asyncio）还依赖__test__ = True，需手动补上：wrapper.__test__ = True - 如果装饰器本身接受参数（如
@my_test_setup(timeout=5)），确保三层嵌套中每一层都正确传递__name__、__doc__、__module__ - 避免在装饰器里动态修改
func.__name__—— pytest 收集时已读取该值，后续改无效
验证是否被正确识别：用 pytest --collect-only 查看真实收集名
这是最直接的诊断方式。它会跳过执行，只输出 pytest 内部“看到”的测试节点名。
对比以下两种输出：
- 正常情况：
<function test_add></function>或<function test_add></function>—— 说明 parametrize 已生效且函数被识别 - 异常情况：
<function wrapper></function>或完全不出现该函数 —— 表明装饰器破坏了函数标识
注意：即使显示 test_add[1-2-3]，也要点开看其 __wrapped__ 是否指向原始函数。可在测试内加一句 print(test_add.__wrapped__) 辅助确认。
兼容性陷阱：混合使用 @pytest.mark.* 和自定义装饰器的顺序
装饰器顺序影响最终对象结构。pytest 的 mark 装饰器（如 @pytest.mark.asyncio）本身也是 wrapper，若放在自定义装饰器外层，可能让 pytest 看不到原始函数。
- ✅ 推荐顺序：自定义装饰器在最外层，pytest mark 在内层（靠近原函数）
- ❌ 危险顺序：
@pytest.mark.asyncio→@my_test_setup→def test_xxx()，此时my_test_setup包裹的是 pytest 的 wrapper，而非原始函数 - 若必须外层用 mark，可在自定义装饰器里主动穿透：
if hasattr(func, '__wrapped__'): func = func.__wrapped__（但需谨慎判断，避免无限递归）
复杂装饰器链下，__wrapped__ 可能多层嵌套，pytest 3.10+ 默认只解一层 —— 这就是为什么升级 pytest 版本是最省事的兜底方案。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
