调用Python代码执行pytest时pytest_runtest_protocol钩子传参异常

嘿，我刚帮你捋清楚这个问题了——你遇到的是类插件钩子方法的签名错误，这是刚接触pytest钩子时很容易踩的坑！

问题根源 #

当你用类来定义pytest插件时，所有钩子方法本质上都是类的实例方法，必须把self作为第一个参数。如果你漏掉了self，pytest的钩子机制会把你的MyPlugin实例本身当成第一个参数传进去，而不是预期的测试用例item——这就是你看到第一个参数是MyPlugin对象的原因，后续自然会因为找不到ihook属性报错。

修复步骤 #

1. 修正钩子方法的签名
   给pytest_runtest_protocol加上self参数，确保参数顺序正确：

   class MyPlugin:
       # 必须加self作为第一个参数
       def pytest_runtest_protocol(self, item, nextitem):
           print(f"当前执行的测试用例: {item.name}")
           # 返回None让pytest继续执行默认的测试流程；如果返回True则接管执行
           return None
   

2. 确认Python API调用pytest的方式正确
   调用pytest.main时，要把插件实例传入plugins参数，而不是直接传类：

   import pytest
   
   if __name__ == "__main__":
       # 实例化插件并传入plugins列表
       pytest.main(["test_your_file.py"], plugins=[MyPlugin()])
   

为什么其他调用方式没问题？ #

如果是用命令行调用pytest，或者用函数式的钩子（不是类），钩子方法不需要self参数，所以不会出现参数错位的情况。但类形式的插件必须遵循Python实例方法的规则，self是必不可少的。

关于你复现的代码 #

原参考代码大概率是用函数式钩子实现的，比如直接定义一个pytest_runtest_protocol函数，而不是放在类里。如果你把它改成类插件，就必须补上self参数，否则就会出现你遇到的参数错位问题。

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