如何在Pytest测试类方法及前置fixture中使用caplog捕获日志？

为啥会出这问题？ #

caplog默认是函数级作用域，而且只有测试函数/方法执行期间才会激活日志捕获。如果你的前置数据准备fixture跑得比caplog初始化还早，或者这个fixture没和caplog关联上，那日志自然抓不到。另外，Test*类里的测试如果有自己的日志配置（比如类级别覆盖了全局配置），也可能导致caplog.text为空。

具体怎么解决？ #

1. 让前置fixture直接依赖caplog #

把caplog作为参数传到前置fixture里，确保日志捕获在fixture执行前就启动：

import pytest
import logging

logger = logging.getLogger(__name__)

@pytest.fixture
def setup_data(caplog):
    # 先设置日志级别，避免因级别过滤导致日志丢失
    caplog.set_level(logging.INFO)
    logger.info("前置fixture生成的日志内容")
    return {"test_data": "sample"}

class TestExample:
    def test_method(self, setup_data, caplog):
        # 验证捕获的日志
        assert "前置fixture生成的日志内容" in caplog.text

2. 用标记提前注入caplog #

不想修改前置fixture参数的话，给测试类或方法加标记，让caplog比前置fixture先初始化：

import pytest
import logging

logger = logging.getLogger(__name__)

@pytest.fixture
def setup_data():
    logger.info("前置fixture的日志")
    return {"test_data": "sample"}

@pytest.mark.usefixtures("caplog")
class TestExample:
    def test_method(self, setup_data, caplog):
        caplog.set_level(logging.INFO)
        assert "前置fixture的日志" in caplog.text

3. 检查并调整日志级别 #

caplog默认只捕获WARNING及以上级别的日志，如果前置fixture输出的是INFO/DEBUG级别的日志，得手动调整级别：

# 在测试方法中临时设置级别
def test_method(self, setup_data, caplog):
    caplog.set_level(logging.DEBUG)
    assert "debug级别的前置日志" in caplog.text

# 或者在conftest.py中全局配置
def pytest_configure(config):
    logging.getLogger(__name__).setLevel(logging.INFO)

4. 匹配fixture的作用域 #

如果前置fixture是模块/类级作用域，需要把caplog的作用域也改成对应级别，确保捕获时机匹配：

@pytest.fixture(scope="class")
def caplog_class(caplog):
    caplog.set_level(logging.INFO)
    yield caplog

@pytest.fixture(scope="class")
def setup_data_class(caplog_class):
    logger.info("类级前置fixture的日志")
    return {"test_data": "class_sample"}

class TestExample:
    def test_class_method(self, setup_data_class, caplog_class):
        assert "类级前置fixture的日志" in caplog_class.text

排查小技巧 #

• 确认日志是通过标准logging模块输出的，caplog抓不到直接用print输出的内容
• 检查pytest版本：低于5.0的旧版本caplog在类测试方法中可能存在兼容问题，建议升级到最新稳定版
• 不要在fixture中自定义添加日志处理器（比如StreamHandler），这会覆盖caplog的捕获处理器

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