Python logging.debug重复输出及日志文件创建失败问题求助

针对logging.basicConfig(filename='example.log', encoding='utf-8', level=logging.DEBUG)无法生成日志文件的情况，可从以下方向排查解决：

• 权限不足：当前运行脚本的用户没有目标目录的写入权限。可更换到有写入权限的路径，比如系统临时目录：

  logging.basicConfig(filename='/tmp/example.log', encoding='utf-8', level=logging.DEBUG)
  

  或者修改目标目录权限，赋予当前用户写入权限。
• 路径错误：相对路径对应的工作目录并非预期目录。改用绝对路径确保文件创建在指定位置：

  import os
  log_path = os.path.join(os.path.dirname(os.path.abspath(__file__)), 'example.log')
  logging.basicConfig(filename=log_path, encoding='utf-8', level=logging.DEBUG)
  

• Python版本兼容问题：encoding参数仅在Python 3.9及以上版本支持。若版本低于3.9，该参数会导致配置失败，日志文件无法创建。可升级Python到3.9+，或改用FileHandler手动指定编码：

  import logging
  handler = logging.FileHandler('example.log', encoding='utf-8')
  logging.basicConfig(level=logging.DEBUG, handlers=[handler])
  

logging.debug重复输出的核心原因是日志器中存在多个相同的Handler，常见解决方法如下：

• 确保basicConfig只执行一次：basicConfig首次调用时会为根日志器添加默认Handler，后续重复调用不会替换原有配置，反而可能重复添加Handler。将basicConfig放在脚本最开头的全局位置，不要在循环、函数内重复调用。
• 清除已有Handler后再配置：若无法避免重复配置场景，先清除根日志器的所有Handler，再重新配置：

  import logging
  root_logger = logging.getLogger()
  # 移除所有已存在的Handler
  for handler in root_logger.handlers[:]:
      root_logger.removeHandler(handler)
  # 重新配置日志
  logging.basicConfig(filename='example.log', encoding='utf-8', level=logging.DEBUG)
  

• 关闭子日志器的传播特性：若使用自定义日志器，子日志器会默认将日志传播给根日志器的Handler，导致重复输出。可关闭传播：

  logger = logging.getLogger(__name__)
  logger.propagate = False
  # 为自定义日志器单独配置Handler
  handler = logging.FileHandler('example.log', encoding='utf-8')
  logger.addHandler(handler)
  logger.setLevel(logging.DEBUG)
  

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