Docker容器创建后立即退出问题排查与解决求助

可能原因及对应解决方案 #

1. requirements.txt中Python版本配置冲突 #

你的requirements.txt里指定了python==3.11.6，但基础镜像已经是python:3.11.6，pip安装时会触发版本校验，可能引发依赖安装异常，最终导致app.py无法正常启动。

解决方法：
删除requirements.txt中的python==3.11.6行，重新构建镜像：

docker build -t demo-gradio-app .

2. Gradio应用未绑定容器可访问端口 #

Gradio默认监听127.0.0.1，在Docker容器内这个地址仅容器内部可见，会导致服务无法对外提供，甚至直接触发进程退出。

解决方法：
修改app.py的启动代码，指定监听0.0.0.0和对应端口：

import gradio as gr

# 示例业务函数，替换为你的实际逻辑
def demo_func(input_text):
    return f"处理结果：{input_text}"

if __name__ == "__main__":
    gr.Interface(fn=demo_func, inputs="text", outputs="text").launch(
        server_name="0.0.0.0",
        server_port=7000  # 与容器映射的端口保持一致
    )

3. 启动命令路径或文件存在性问题 #

可能app.py不在容器的工作目录下，或者启动命令的路径写错了。

验证与解决：
临时启动容器进入交互模式，检查文件结构并手动测试运行：

docker run --rm -it demo-gradio-app bash
# 进入容器后执行
ls -l /usr/src/app  # 确认app.py是否存在
python3 ./app.py    # 手动运行，查看是否有报错信息

根据实际文件位置调整Dockerfile中的CMD路径。

4. 依赖安装不完整或失败 #

镜像构建日志可能没显示细节，某些依赖（如torch）可能因网络、平台适配问题安装失败，导致app.py运行时崩溃。

解决方法：
重新构建镜像时查看详细安装日志：

docker build --progress=plain -t demo-gradio-app .

根据日志中的失败提示处理对应依赖，比如更换pip源、指定torch的适配版本。

5. 容器启动参数冲突 #

你同时使用了-it和-d参数，虽然大部分场景下兼容，但如果app.py依赖终端交互（Gradio服务通常不需要），可能导致进程退出。

尝试调整启动命令：
前台运行容器查看实时输出，直接定位报错：

docker run --name my-app -p 7000:7000 demo-gradio-app

如果服务正常启动，再改用-d后台运行：

docker run -d --name my-app -p 7000:7000 demo-gradio-app

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