1. 构建镜像时无输出？别在构建阶段启动服务 #

构建镜像时如果直接执行python gradio_app.py，Gradio会启动服务并一直阻塞进程，导致Docker构建阶段卡住、无输出甚至失败。

正确姿势是：Dockerfile只做环境搭建、依赖安装、代码复制这些准备工作，把启动Gradio的命令放到CMD或ENTRYPOINT里，让容器运行时再执行。示例Dockerfile：

# 选用适配项目的带CUDA基础镜像
FROM nvidia/cuda:12.1.1-cudnn8-runtime-ubuntu22.04

# 安装Python及基础工具
RUN apt-get update && apt-get install -y python3 python3-pip
COPY requirements.txt .
RUN pip3 install --no-cache-dir -r requirements.txt

# 复制项目代码到容器内
COPY . /app
WORKDIR /app

# 容器启动时才执行启动命令
CMD ["python3", "gradio_app.py"]

2. 运行容器时URL只在终止时显示？解决Python输出缓冲 #

这是Python在Docker里的常见问题——输出被缓冲，Gradio的启动日志没实时打印，直到进程终止才一次性输出。两种解决办法：

方法一：启动Python时禁用缓冲 #

修改Dockerfile里的CMD，加上-u参数强制Python无缓冲输出：

CMD ["python3", "-u", "gradio_app.py"]

或者直接在运行容器时指定命令：

docker run --network host --gpus all latentsync python3 -u gradio_app.py

方法二：在代码里手动刷新缓冲 #

打开gradio_app.py，在启动Gradio的前后添加刷新输出的代码，同时务必把Gradio绑定到0.0.0.0（否则容器外无法访问）：

import sys
import gradio as gr

# 你的Gradio应用逻辑
def your_sync_function():
    return "LatentSync is running!"

demo = gr.Interface(fn=your_sync_function, inputs=None, outputs="text")

# 刷新缓冲再启动服务
sys.stdout.flush()
# 必须指定server_name为0.0.0.0，确保容器外可访问
demo.launch(server_name="0.0.0.0")
sys.stdout.flush()

3. 额外排查点 #

• 进容器手动测试：运行容器进入交互模式，手动启动服务验证输出，确认依赖和环境正常：

  docker run -it --network host --gpus all latentsync bash
  # 进入容器后执行
  python3 gradio_app.py
  

• 查看Docker日志：启动容器后，新开终端执行docker logs <容器ID>，排查是否有隐藏报错信息。
• 确认端口绑定：即便用了--network host，Gradio默认绑定127.0.0.1，改成0.0.0.0才能保证外部正常访问。

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