Docker容器日志输出延迟：日志无法随容器输出实时写入

你遇到的是Python标准输出缓冲导致的日志延迟问题——Python在非交互式环境（比如Docker容器）中默认会缓冲stdout内容，积累到一定量才会批量写入，所以docker logs会间隔很久才看到新日志。以下是几种解决方法：

方法1：运行Python时禁用缓冲 #

在启动脚本的命令中添加-u参数，强制Python不缓冲输出：

python -u your_script.py

如果是在Dockerfile里的CMD或ENTRYPOINT，修改成：

CMD ["python", "-u", "your_script.py"]

方法2：在Python脚本中手动刷新输出 #

每次调用print时加上flush=True参数，确保输出立即写入：

import time

count = 0
while True:
    print(f"Waiting for file... {count} seconds passed", flush=True)
    count += 1
    time.sleep(1)

或者在输出后手动刷新stdout：

import sys
import time

count = 0
while True:
    print(f"Waiting for file... {count} seconds passed")
    sys.stdout.flush()
    count += 1
    time.sleep(1)

方法3：设置环境变量禁用缓冲 #

在Dockerfile中添加环境变量PYTHONUNBUFFERED=1，让Python默认不缓冲输出：

ENV PYTHONUNBUFFERED=1
CMD ["python", "your_script.py"]

或者运行容器时通过-e参数设置：

docker run -e PYTHONUNBUFFERED=1 your_image_name

以上任意一种方法都能让你的日志实时出现在docker logs中，不会再出现批量延迟写入的情况。

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