Python3.10.4中pytest_sessionfinish钩子未触发的问题排查

Python 3.10.4 本身和 pytest 的 pytest_sessionfinish 钩子没有兼容性问题，钩子未被调用大概率是代码位置、定义方式或 pytest 配置的问题，以下是常见原因及解决办法：

1. 钩子函数放错了位置 #

pytest 不会自动加载单个测试文件里的钩子函数，除非你把该文件当作插件显式加载。正确的做法是把钩子函数放在项目根目录或测试目录下的 conftest.py 文件中——这是 pytest 默认会扫描加载的插件配置文件，全局生效。

示例 conftest.py 代码：

import pytest

@pytest.hookimpl
def pytest_sessionfinish(session, exitstatus):
    # 这里写你要执行的特定操作
    print(f"所有测试执行完毕，退出状态码：{exitstatus}")

如果非要把钩子写在测试文件里，需要用 -p 参数指定加载该文件作为插件，运行命令改为：

pytest -v -p exemple.py

但这种方式不推荐，不利于钩子的复用和维护。

2. 钩子函数参数错误 #

pytest_sessionfinish 的标准参数是 (session, exitstatus)，如果参数个数不对、参数名错误，pytest 会跳过调用这个钩子。检查你的函数定义，确保和标准签名一致。

错误示例（参数缺失）：

# 这个钩子不会被调用
@pytest.hookimpl
def pytest_sessionfinish():
    print("测试完成")

3. pytest 版本过旧 #

虽然 Python 3.10.4 没问题，但如果你的 pytest 版本太老（比如低于 6.2.0），可能对 Python 3.10 的兼容性或钩子装饰器的处理有问题。执行以下命令更新 pytest 到兼容版本：

pip install --upgrade pytest

确保 pytest 版本在 6.2.5 及以上（完全支持 Python 3.10）。

4. 钩子实现标记配置不当 #

如果你的钩子需要优先执行或覆盖默认实现，可能需要给 @pytest.hookimpl 添加参数，比如 tryfirst=True 或 hookwrapper=True，但默认情况下，只要参数正确、位置正确，不需要额外配置也能被调用。

内容的提问来源于stack exchange，提问作者Pierre G.