根本原因是Python在容器中默认启用全缓冲模式，stdout不刷新则Docker无法捕获；设置PYTHONUNBUFFERED=1可强制禁用缓冲，使print()和logging.info()日志实时输出至docker logs。
为什么 Flask 在 Docker 里 print() 和 logging.info() 看不到日志
根本原因是 Python 在容器中默认启用全缓冲模式：stdout 不遇到换行或缓冲区满就不会刷出，而 Docker 的 docker logs 只捕获 stdout/stderr 流——没刷新，就等于没输出。这不是 Flask 的问题，也不是 Docker 日志驱动坏了，是 Python 运行时环境误判为“非交互式”，自动锁死了输出通道。
设置 PYTHONUNBUFFERED=1 是最直接有效的解法
这个环境变量会强制 Python 解释器禁用 sys.stdout 和 sys.stderr 的所有缓冲，等效于启动时加 -u 参数。它不改代码、不改日志库、不依赖终端分配，只要生效，print("ok") 和 logging.info("ready") 就能秒级出现在 docker logs -f 里。
- 在
Dockerfile中声明（推荐）：ENV PYTHONUNBUFFERED=1
- 运行时临时验证：
docker run -e PYTHONUNBUFFERED=1 your-flask-app - 注意：该变量只影响当前 Python 进程，对 gunicorn 子进程也生效（前提是 gunicorn 启动方式未覆盖环境）
Flask + gunicorn 组合下容易漏掉的坑
即使设置了 PYTHONUNBUFFERED，gunicorn 仍可能把日志吞掉——因为它默认把 access log 和 error log 写到文件，而非 stdout。Docker 根本收不到这些日志。
- 必须显式让 gunicorn 输出到标准流：
--access-logfile - --error-logfile - - 避免使用
--daemon，它会让 gunicorn fork 后台进程，导致主进程退出、容器提前终止 - Flask 自身 logger 若未配置
StreamHandler(sys.stdout)，也可能静默丢弃 info 级日志（尤其在生产模式下） - 检查是否意外重定向了 stderr，比如代码里写了
sys.stderr = open('/dev/null', 'w')—— 这种写法会让所有错误日志彻底消失
验证是否真正生效的三步检查法
别只信配置写了，要亲眼看到日志流动起来才算数。
立即学习“Python免费学习笔记（深入）”；
- 启动容器后立刻执行：
docker logs -f --tail 10 your-container，观察是否有类似* Running on http://0.0.0.0:5000/的 Flask 启动提示 - 发一个请求，看日志里是否实时出现 access log 行（格式如
172.17.0.1 - - [28/Apr/2026:15:39:00] "GET /health HTTP/1.1" 200 -） - 在 Flask 路由里加一行
print(f"[DEBUG] {time.time()}", flush=True)—— 如果不用flush=True也能立即打印，说明PYTHONUNBUFFERED已起作用；如果仍需手动flush，说明环境变量没传进 Python 进程（常见于多层 shell wrapper 未透传）
最容易被忽略的是：gunicorn 的日志开关和 Flask 的 logger 配置是两套独立系统，PYTHONUNBUFFERED 只管 Python 底层流，不管上层框架怎么分发日志。所以光设环境变量不够，还得确保日志最终落到了 stdout 上。
