Python无限循环Docker容器无法独立运行的问题排查问询

问题场景 #

从单一仓库启动3个Docker容器，文件结构如下：

.
├── docker
│   ├── inf1
│   │   └── Dockerfile
│   ├── inf2
│   │   └── Dockerfile
│   └── proc1
│       └── Dockerfile
├── docker-compose.yaml
├── example
│   ├── __init__.py
│   ├── infinite_process1.py
│   ├── infinite_process2.py
│   └── stop_process.py
├── exe_inf1.py
├── exe_inf2.py
└── exe_proc.py

其中infinite_process1.py和infinite_process2.py包含while True无限循环逻辑，exe_*.py对应启动各进程类，Docker基于python:3.10.7构建，docker-compose配置三个服务。实际运行后，仅非循环容器正常输出退出，两个无限循环容器无预期输出。

常见问题原因及解决方法 #

1. Python输出缓冲导致无日志 #

Docker环境中Python默认开启输出缓冲，无限循环里的print内容会被暂存缓冲区，不会实时输出到容器日志。

解决方法二选一：

• 启动命令添加-u参数禁用缓冲：修改Dockerfile或docker-compose的启动命令为python -u exe_inf1.py
• 代码中强制刷新缓冲区：修改print语句为print("InfProcess 1", flush=True)

2. 启动脚本未正确调用循环方法 #

需确保exe_inf1.py和exe_inf2.py中正确实例化类并调用循环方法，示例代码如下：

# exe_inf1.py
from example.infinite_process1 import InfiniteProcess1

if __name__ == "__main__":
    process = InfiniteProcess1()
    process.infinite_loop()

如果缺少这段调用逻辑，脚本执行后会直接退出，不会进入无限循环。

3. Docker构建或配置错误 #

• 检查Dockerfile是否完整复制了所有代码文件，比如是否通过COPY . .将项目文件全部复制到容器内
• 确认docker-compose.yaml中各服务的build路径正确，指向对应Dockerfile所在目录
• 可通过docker logs <容器ID>命令查看容器日志，排查是否有脚本执行报错

内容的提问来源于stack exchange，提问作者배상일