调用logging.config.dictConfig后日志为空，如何排查Python logging配置问题

调试日志器运行行为的方法 #

你可以通过以下几种方式追踪日志事件的完整流转：

• 开启日志框架内部异常抛出：在加载日志配置前添加代码 logging.raiseExceptions = True，日志处理过程中出现的所有异常（比如文件无写入权限、handler初始化失败）都会直接抛出，不会被静默吞掉。
• 遍历打印所有日志器的实际配置：添加如下工具函数，调用即可直观看到所有日志器的层级、绑定的handler、传播属性等和你预期是否一致：

import logging

def print_all_logger_configs():
    # 打印根日志器配置
    root = logging.getLogger()
    print(f"[根日志器] 级别: {logging.getLevelName(root.level)}, 绑定handler: {[h.name for h in root.handlers]}, 传播开关: {root.propagate}, 禁用开关: {root.disabled}")
    # 遍历所有已注册的子日志器
    for name, logger in logging.root.manager.loggerDict.items():
        if isinstance(logger, logging.Logger):
            print(f"[日志器{name}] 级别: {logging.getLevelName(logger.level)}, 绑定handler: {[h.name for h in logger.handlers]}, 传播开关: {logger.propagate}, 禁用开关: {logger.disabled}")

• 新增调试过滤器追踪日志流转：给根日志器添加如下过滤器，所有日志事件的处理过程都会被打印出来：

class LogFlowDebugFilter(logging.Filter):
    def filter(self, record):
        print(f"[日志流转追踪] 所属日志器: {record.name}, 级别: {record.levelname}, 内容: {record.getMessage()}")
        return True

# 绑定到根日志器
logging.getLogger().addFilter(LogFlowDebugFilter())

之后你执行 logging.getLogger('test').warn('test') 就能完整看到这条日志有没有被丢弃、有没有走到对应的handler。

根日志器无输出的常见原因 #

结合你提到的Cherrypy场景，大概率是以下几种问题：

• 配置加载顺序错误：Cherrypy启动时会自动初始化自身的日志配置，如果你在Cherrypy启动前加载了你的日志配置，Cherrypy的初始化逻辑会覆盖/清空根日志器的handler。你需要调整加载顺序，在Cherrypy完成启动、日志初始化执行结束后再加载你的dictConfig配置。
• disable_existing_loggers 参数问题：logging.config.dictConfig 方法的 disable_existing_loggers 参数默认值为True，会禁用所有配置中未明确列出的已存在日志器，如果你的业务日志器都没有在配置中声明，且设置了不向上传播，日志就不会到根日志器。你可以调用dictConfig时显式指定 disable_existing_loggers=False 避免这个问题。
• 工作目录不匹配：你配置的日志路径是相对路径，Cherrypy启动时的工作目录和你单文件测试时的工作目录不一致，日志文件被写入到了其他路径，并非没有生成。你可以把filename改成绝对路径测试验证。
• 根日志器被意外修改：项目中其他位置的代码调用了 logging.basicConfig、或者直接修改了根日志器的disabled属性、清空了根日志器的handler，你可以用上面的打印配置函数确认根日志器的最终状态。

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