如何用Pytest断言Logger输出到Stdout？问题求助

常见原因及对应解决方案 #

1. Logger未正确绑定到标准输出 #

多数捕获失败的情况，是因为Logger没有添加指向stdout的StreamHandler，或者Handler的级别高于日志输出级别。

正确的Logger配置示例：

import logging
import sys

def setup_logger():
    logger = logging.getLogger("my_logger")
    logger.setLevel(logging.INFO)
    # 明确添加指向stdout的StreamHandler
    handler = logging.StreamHandler(sys.stdout)
    handler.setLevel(logging.INFO)
    formatter = logging.Formatter("%(levelname)s: %(message)s")
    handler.setFormatter(formatter)
    logger.addHandler(handler)
    return logger

如果使用默认Handler，日志可能会输出到stderr而非stdout，此时用capfd（同时捕获stdout和stderr）替代capsys即可。

2. 日志缓冲区未及时刷新 #

日志模块在非交互式环境（如Pytest运行时）默认启用缓冲，可能导致日志还未输出到标准流就被capsys/capfd读取。解决方式有两种：

• 配置Handler自动刷新：

  handler = logging.StreamHandler(sys.stdout)
  handler.flush = True  # 开启自动刷新
  

• 测试中手动刷新缓冲区：

  def test_log_output(capsys):
      logger = setup_logger()
      logger.info("Test log content")
      sys.stdout.flush()  # 手动刷新
      captured = capsys.readouterr()
      assert "Test log content" in captured.out
  

3. Logger的propagate属性被禁用 #

若设置了logger.propagate = False，且根Logger未配置对应Handler，日志无法向上传播到根Logger的默认输出通道，导致捕获失败。检查并确保propagate设置合理，或直接给目标Logger添加Handler。

4. Pytest内置日志捕获机制冲突 #

Pytest默认自带日志捕获功能，可能与capsys/capfd冲突。可通过以下方式禁用：

• 命令行运行时禁用：

  pytest --no-capture
  

• 测试函数内临时禁用：

  def test_log_capture(capsys, monkeypatch):
      monkeypatch.setenv("PYTEST_DISABLE_LOGGING", "1")
      logger = setup_logger()
      logger.info("Target log")
      sys.stdout.flush()
      captured = capsys.readouterr()
      assert "Target log" in captured.out
  

完整可运行测试示例 #

import logging
import sys
import pytest

def setup_logger():
    logger = logging.getLogger("test_logger")
    logger.setLevel(logging.DEBUG)
    # 避免重复添加Handler
    if not logger.handlers:
        handler = logging.StreamHandler(sys.stdout)
        handler.setLevel(logging.DEBUG)
        handler.setFormatter(logging.Formatter("%(message)s"))
        handler.flush = True
        logger.addHandler(handler)
    logger.propagate = False
    return logger

def test_capture_log(capsys):
    logger = setup_logger()
    test_msg = "Hello from test logger"
    logger.info(test_msg)
    sys.stdout.flush()
    captured = capsys.readouterr()
    assert test_msg in captured.out

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