配置structlog后pytest无法发现全部测试用例如何解决？

你遇到的I/O报错是因为pytest在收集测试用例阶段，会默认劫持stdout/stderr输出到临时文件用于后续结果统计，而你的structlog配置在导入阶段就直接初始化了全局的StreamHandler，替换了pytest劫持的流句柄。当pytest中途关闭自己的临时文件句柄时，日志handler仍尝试操作已关闭的文件对象，导致用例收集流程中断，因此仅能收集到未导入日志配置的5条用例。

1. 禁止在模块导入阶段直接调用日志配置 #

不要在structlogconf.py或者业务模块、测试模块的顶层作用域直接调用configure()函数，仅在程序正式入口（比如if __name__ == "__main__": 分支内）执行配置，避免pytest用例收集阶段提前触发日志初始化。

2. 适配pytest运行场景做差异化配置 #

你可以在日志配置逻辑中增加运行环境判断，pytest运行时不注册全局StreamHandler，避免和pytest的输出捕获逻辑冲突：

import sys
def configure() -> None:
    is_pytest_runtime = "pytest" in sys.modules
    timestamper = structlog.processors.TimeStamper(fmt="%Y-%m-%d %H:%M:%S")
    pre_chain = [
        structlog.stdlib.add_log_level,
        timestamper,
    ]
    handlers = {}
    # 非pytest环境才添加控制台输出handler
    if not is_pytest_runtime:
        handlers["default"] = {
            "level": "DEBUG",
            "class": "logging.StreamHandler",
            "formatter": "colored",
        }
    # 始终保留文件日志handler
    handlers["file"] = {
        "level": "DEBUG",
        "class": "logging.handlers.WatchedFileHandler",
        "filename": "test.log",
        "formatter": "plain",
    }
    logging.config.dictConfig(
        {
            "version": 1,
            "disable_existing_loggers": False,
            "formatters": {
                "plain": {
                    "()": structlog.stdlib.ProcessorFormatter,
                    "processor": structlog.dev.ConsoleRenderer(colors=False),
                    "foreign_pre_chain": pre_chain,
                },
                "colored": {
                    "()": structlog.stdlib.ProcessorFormatter,
                    "processor": structlog.dev.ConsoleRenderer(colors=True),
                    "foreign_pre_chain": pre_chain,
                },
            },
            "handlers": handlers,
            "loggers": {
                "": {
                    "handlers": list(handlers.keys()),
                    "level": "DEBUG",
                    "propagate": True,
                },
            },
        }
    )
    # 原structlog.configure逻辑保持不变即可

3. 通过pytest钩子在正确时机初始化日志 #

如果你需要在测试阶段也保留structlog的控制台输出，可以在项目测试目录下新增conftest.py文件，通过pytest的生命周期钩子在pytest完成输出劫持后再初始化日志配置：

# conftest.py
from your_package.structlogconf import configure

def pytest_sessionstart(session):
    # pytest会话启动、输出劫持完成后再初始化日志
    configure()

你可以先执行pytest --collect-only -s命令关闭pytest的输出捕获，如果此时能正常收集到全部40条用例，即可确认是流劫持冲突导致的问题，再按上述方案调整即可。

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