自定义Python镜像运行容器时docker logs输出非实时分批打印问题咨询

Python默认会对标准输出(stdout)做缓冲策略：当运行在非交互终端环境（即Docker后台运行容器的场景）时，stdout默认启用块缓冲，只有缓冲区写满、或者程序退出时才会批量输出内容，这就是你看到日志批次打印的根本原因。
你已经确认业务逻辑2秒执行一次是正常的，说明问题完全出在输出缓冲层，和业务代码无关。

以下方案任选一种即可：

• 方案1：给Python解释器添加无缓冲参数
  修改Dockerfile中的ENTRYPOINT配置，添加-u参数禁用输出缓冲：

# 原ENTRYPOINT
# ENTRYPOINT ["/usr/local/bin/python3"]
# 修改后
ENTRYPOINT ["/usr/local/bin/python3", "-u"]

修改后重新构建镜像运行即可生效。

• 方案2：添加PYTHONUNBUFFERED环境变量
  在Dockerfile中新增环境变量配置，全局禁用Python输出缓冲：

# syntax=docker/dockerfile:1
FROM python:3.8-slim-buster
# 新增这行
ENV PYTHONUNBUFFERED=1
ADD requirements.txt /
ADD mqtt_client.py /
RUN pip3 install -r requirements.txt
CMD ["/mqtt_client.py"]
ENTRYPOINT ["/usr/local/bin/python3"]

或者运行容器时直接传入环境变量：
docker run -e PYTHONUNBUFFERED=1 <你的镜像名>

• 方案3：修改print语句手动刷新缓冲
  在每次print时添加flush=True参数，强制每次打印后立即刷出缓冲区内容：

print(f"Publishing to topic: {topic}\n\tPayload: {point}", flush=True)

这个方案不需要修改镜像配置，直接改业务代码即可生效。

修改后重新运行容器，执行docker logs -f <容器ID/容器名>，即可看到日志按照2秒间隔实时输出。

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