为何导入dataclasses会导致Python logging模块停止工作？

• 核心原因：Python 3.9.x中，dataclasses模块在导入过程中会间接触发logging系统的初始化——其依赖的内部模块会调用logging相关操作，导致根日志器被自动分配了默认的流处理器。而logging.basicConfig()的设计逻辑是仅当根日志器没有任何处理器时才会生效，当dataclasses提前给根日志器加了处理器，后续你的basicConfig()调用就会被忽略，日志自然不会写入指定文件。

• 验证方式：可以在导入dataclasses后、调用basicConfig()前，打印根日志器的处理器列表，能看到已经存在默认处理器：

  import logging
  import dataclasses
  
  print(logging.getLogger().handlers)  # 输出会包含一个StreamHandler实例
  logging.basicConfig(
      filename="logfile.log",
      level=logging.DEBUG,
  )
  

• 解决方法：

  1. 调整导入顺序：把logging.basicConfig()的调用放在所有可能触发logging初始化的模块导入之前：

     import logging
     
     # 先配置日志
     logging.basicConfig(
         filename="logfile.log",
         level=logging.DEBUG,
     )
     
     # 再导入dataclasses
     import dataclasses
     
     def main():
         logging.info("This is an info message")
         logging.error("This is an error message")
     
     if __name__ == "__main__":
         main()
     

  2. 手动添加处理器：如果无法调整导入顺序，可手动创建并添加文件处理器，绕过basicConfig()的限制：

     import logging
     import dataclasses
     
     logger = logging.getLogger()
     logger.setLevel(logging.DEBUG)
     # 清空可能存在的默认处理器（避免重复输出）
     for handler in logger.handlers[:]:
         logger.removeHandler(handler)
     # 添加文件处理器
     file_handler = logging.FileHandler("logfile.log")
     formatter = logging.Formatter("%(asctime)s - %(name)s - %(levelname)s - %(message)s")
     file_handler.setFormatter(formatter)
     logger.addHandler(file_handler)
     
     def main():
         logging.info("This is an info message")
         logging.error("This is an error message")
     
     if __name__ == "__main__":
         main()
     

• 是否是Python Bug？：严格来说不算核心Bug，属于模块导入时的副作用导致的意外行为。该问题在Python 3.10及以上版本中已被修复，dataclasses模块导入不再会触发logging的默认处理器初始化。

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