Docker环境下Python进程capture.py的print输出无法在终端显示的技术咨询

该现象和capture服务的运行状态无关，核心诱因有两类：

• Python 非交互场景下的默认缓冲机制：容器内 Python 运行时未连接终端（tty），默认将 stdout 设置为块缓冲，只有缓冲区被填满、或者程序主动退出时才会把print内容刷出到日志流。server服务的输出量可能刚好达到了缓冲区刷新阈值，所以可以正常显示；而capture的输出量不足、且处于长运行的视频处理状态，没有主动触发缓冲区刷新，print内容会一直滞留在内存中，不会输出到终端。
• 日志流被重定向：如果capture.py代码中有重定向标准输出的逻辑，print内容会被写入容器内部的文件，不会被Docker捕获输出。

优先调整输出缓冲（90%以上场景可解决） #

三选一即可，推荐前两种低改动成本的方式：

1. 给Python启动命令加无缓冲参数-u，修改docker-compose.local.yaml中capture服务的command配置：

capture:
  build: ./app
  depends_on:
    - init
    # 原有命令前增加 python -u，强制关闭输出缓冲
  command: ['python', '-u', 'capture.py', '--url', 'redis://redisedge:6379', 'data/walking.mp4']

注：如果当前镜像的ENTRYPOINT已经默认是python，则直接在脚本名前加-u即可，即command改为['-u', 'capture.py', '--url', 'redis://redisedge:6379', 'data/walking.mp4']
2. 通过环境变量全局关闭Python缓冲，不需要修改启动命令：

capture:
  build: ./app
  depends_on:
    - init
  environment:
    - PYTHONUNBUFFERED=1
  command: ['capture.py', '--url', 'redis://redisedge:6379', 'data/walking.mp4']

3. 单条print手动触发刷新：如果不想修改配置，也可以给所有需要输出的print语句加flush=True参数，例如：

print("捕获帧处理完成", flush=True)

排查日志重定向问题 #

检查capture.py代码中是否存在类似sys.stdout = open("xxx.log", "w")的重定向逻辑，这类代码会把所有print输出写入容器内部的本地文件，不会输出到Docker日志流。删除该类重定向逻辑、或者将输出目标改回stdout即可。

验证日志输出 #

修改配置后重启服务即可正常看到输出，也可以单独拉取capture服务的实时日志确认：

# 仅查看capture服务的实时输出
docker-compose logs -f capture

补充说明：server.py中导入capture模块但未使用的逻辑，和该问题完全无关，不会影响capture服务的日志输出，无需调整。

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