在Docker环境中使用Python logging模块无日志输出问题求助

排查和解决方法 #

• 配置被提前覆盖问题
  Python的logging.basicConfig()仅在首次调用时生效，若你的代码在加载该配置前，引入的第三方依赖或其他前置代码已经调用过basicConfig，你的自定义配置会直接失效。本地运行正常、容器内失效大概率是不同环境下依赖加载顺序差异导致的。
  解决方法：Python 3.8及以上版本可以在配置参数中添加force=True强制覆盖已存在的日志配置：

log.basicConfig(level=log.DEBUG,
            format='%(asctime)s: %(levelname)s [%(filename)s:%(lineno)s] %(message)s',
            datefmt='%I:%M:%S %p',
            handlers=[
                log.FileHandler('admin_logs.log'),
                log.StreamHandler()
            ],
            force=True)

• 日志文件写入权限问题
  容器内运行Python进程的用户对当前工作目录可能没有写入权限，导致FileHandler无法创建、写入日志文件。
  排查方法：执行docker exec -it 你的容器ID bash进入容器，在项目目录下执行touch test.log确认是否有权限写入。
  解决方法：要么给项目目录授予运行进程用户的写入权限，要么将日志文件路径指定到确定可写的目录（如/tmp/admin_logs.log）。
• 输出流与缓冲问题
  默认StreamHandler()输出到sys.stderr，而部分场景下你可能只捕获了stdout输出；同时Python在非交互模式（容器运行环境）下默认会开启输出缓冲，导致日志不会实时打印。
  解决方法：
  1. 手动指定StreamHandler的输出流为stdout：log.StreamHandler(stream=sys.stdout)（注意提前import sys）
  2. 运行Python脚本时添加-u参数关闭缓冲：python -u your_script.py，或者在Dockerfile中添加环境变量ENV PYTHONUNBUFFERED=1
• 日志级别被篡改问题
  如果有其他代码在你配置完成后修改了root logger的日志级别，也会导致低级别日志无法输出。你可以在配置代码后添加一行校验日志级别：

print(log.getLogger().level)

DEBUG对应的数值为10，如果输出数值大于10，说明日志级别被修改为更高的INFO/WARNING等级，需要找到对应修改位置删除，或在你的配置最后重新指定root logger级别：log.getLogger().setLevel(log.DEBUG)

内容的提问来源于stack exchange，提问作者arturo.p96