### Python `logging` 模块不输出的原因及解决方案 #### 原因分析 1. **未设置基础配置** 如果没有调用 `basicConfig()` 或者其他初始化方法来配置日志记录器，那么默认情况下不会有任何日志被输出。这是因为根日志记录器（root logger）的级别默认为 `WARNING`，低于此级别的消息会被忽略[^2]。 2. **日志级别设置不当** 日志记录器或处理器的日志级别可能高于实际使用的日志级别（如 `DEBUG`）。只有当消息的日志级别等于或高于记录器和处理程序的级别时，才会输出相应的日志信息[^1]。 3. **缺少有效的处理器（Handlers）** 即使设置了日志记录器，如果没有为其添加任何处理器（Handler），或者现有的处理器未能正确连接到目标位置（如控制台或文件），也不会有日志输出[^3]。 4. **重复初始化问题** 当多次初始化同一个日志记录器而未清理旧有的处理器时，可能会导致日志重复输出甚至完全不出的情况。这通常发生在多线程或多模块环境中。 5. **Propagate 属性的影响** 默认情况下，子日志记录器会将其事件传递给父级日志记录器进行进一步处理。如果某个中间层关闭了传播功能 (`propagate=False`) ，则后续更高层次的日志管理链路将中断[^4]。 6. **Configuration 文件加载冲突** 使用 `fileConfig()` 函数读取外部配置文件时，默认参数 `disable_existing_loggers=True` 可能禁用了已存在的日志实例。除非显式指定保留现有日志器，否则它们的功能会被屏蔽[^5]。 --- #### 解决方案 ##### 方法一： 设置基本配置 通过调用 `logging.basicConfig(level=logging.DEBUG)` 来全局设定最低显示等级以及其它必要选项。 ```python import logging logging.basicConfig( level=logging.DEBUG, format='%(asctime)s - %(name)s - %(levelname)s - %(message)s', handlers=[logging.StreamHandler()] ) logging.debug("This is a debug message.") ``` ##### 方法二： 调整日志级别 确保所创建的日志记录器及其关联的所有处理器都具有适当范围内的敏感度阈值。 ```python logger = logging.getLogger() logger.setLevel(logging.DEBUG) # 设定较低的日志级别以便捕获更多细节 console_handler = logging.StreamHandler() console_handler.setLevel(logging.DEBUG) formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s') console_handler.setFormatter(formatter) logger.addHandler(console_handler) ``` ##### 方法三： 避免重复初始化 在每次重新定义新的 Logger 实例之前先检查当前是否有已经注册过的 Handlers 存在；如果有，则跳过再次声明过程以防干扰既有逻辑结构。 ```python if not logger.handlers: handler = logging.StreamHandler(sys.stdout) formatter = logging.Formatter("%(asctime)s;%(levelname)s;%(message)s", "%Y-%m-%d %H:%M:%S") handler.setFormatter(formatter) logger.addHandler(handler) else: pass # 已经存在 Handler，无需额外操作 ``` ##### 方法四： 控制 Propagation 行为 对于特定场景下的独立型 Loggers 应考虑调整其 propagate 参数状态以避免不必要的数据转发现象发生。 ```python child_logger = logging.getLogger('module.submodule') child_logger.propagate = False # 关闭向上一层发送通知机制 ``` ##### 方法五： 修改 File Config 加载策略 修改 `fileConfig()` 的调用方式使其兼容现存的对象而不至于意外移除重要组件。 ```python from configparser import RawConfigParser import logging.config config_parser = RawConfigParser() with open('/path/to/logging.conf', 'r') as f: config_parser.read_file(f) logging.config.fileConfig(config_parser, disable_existing_loggers=False) ``` --- ###