运行Docker镜像时无报错即停止，如何启动API服务并排查问题？

一、先搞定路径和虚拟环境的坑 #

你的Dockerfile和shell脚本的路径匹配有问题，容易导致虚拟环境激活失败或者启动命令执行异常，给你两种修复方式：

方式1：直接在Dockerfile里写启动命令（更简洁） #

FROM python:3.8

# 把应用目录和虚拟环境目录分开，避免混乱
WORKDIR /app

# 创建虚拟环境，直接把虚拟环境的bin目录加入PATH，不用每次手动激活
RUN python3 -m venv /opt/venv
ENV PATH="/opt/venv/bin:$PATH"

# 安装依赖
COPY requirements.txt .
RUN pip install -r requirements.txt

# 复制应用代码
COPY /myappp .

EXPOSE 8000

# 直接启动服务，省得写脚本踩路径坑
CMD ["python", "manage.py", "runserver", "0.0.0.0:8000"]

方式2：修改shell脚本（如果非要用脚本） #

先调整Dockerfile的工作目录：

FROM python:3.8

# 把工作目录设为/app，和虚拟环境目录/opt/venv分开
WORKDIR /app

RUN python3 -m venv /opt/venv

COPY requirements.txt .
RUN . /opt/venv/bin/activate && pip install -r requirements.txt

EXPOSE 8000
COPY /myappp .
CMD ./script.sh

再修改shell脚本，用绝对路径激活虚拟环境，确保在应用目录执行命令：

#!/bin/bash
# 用绝对路径激活，避免当前目录不对导致找不到脚本
source /opt/venv/bin/activate
# 切换到应用目录
cd /app
python manage.py runserver 0.0.0.0:8000

二、解决NLTK下载顺序的问题 #

容器里NLTK在训练完才下载，是因为你项目里的NLTK数据下载代码写在训练逻辑里了，没在镜像构建阶段提前处理。直接在Dockerfile的依赖安装步骤后加一行提前下载：

# 替换成你实际需要的NLTK模型名称
RUN python -c "import nltk; nltk.download(['punkt', 'averaged_perceptron_tagger', 'stopwords'])"

这样构建镜像时就会下载好NLTK数据，和你本地运行的顺序一致，不会等到训练时才触发下载。

三、排查进程停止的问题 #

如果改完还是训练完就停，没启动API服务，试试这两步：

• 检查你的训练逻辑是不是和服务启动绑定的？比如是不是训练脚本执行完就直接退出了，没接着启动runserver？得确保训练完成后才启动服务器。
• 手动进容器排查报错：

docker exec -it <你的容器ID> /bin/bash
# 进去后激活虚拟环境，手动跑启动命令看具体报错
source /opt/venv/bin/activate
python manage.py runserver 0.0.0.0:8000

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