Docker容器中Django应用依赖问题排查求助

核心问题分析 #

从日志能明确两个关键故障点：

• honcho: not found：容器内未安装honcho进程管理工具
• ModuleNotFoundError: No module named 'django'：Python依赖（含Django）未正确安装到容器运行环境

具体修复步骤 #

1. 确保依赖文件正确编译与安装 #

如果使用requirement.in管理依赖，必须通过pip-tools生成可直接安装的requirements.txt，Dockerfile里要完整包含这个流程：

# 安装pip-tools工具
RUN pip install pip-tools

# 从requirement.in编译生成requirements.txt
RUN pip-compile requirements.in

# 安装所有项目依赖
RUN pip install -r requirements.txt

如果已经预先生成了requirements.txt，跳过编译步骤，但要确保文件被正确COPY到容器内。

2. 规范Dockerfile的文件复制顺序 #

先复制依赖文件再安装，利用Docker缓存减少重复构建，同时确保依赖安装时文件已存在：

# 设置容器工作目录
WORKDIR /app

# 先复制依赖配置文件
COPY requirements.in .
COPY requirements.txt .

# 执行依赖安装（步骤同上）

# 最后复制项目代码
COPY . .

3. 验证honcho是否在依赖清单中 #

打开requirements.in，确认已添加honcho：

# requirements.in
django>=4.2
honcho>=1.1.0
# 其他项目依赖...

如果之前漏加，补充后重新编译安装。

4. 优化启动命令的进程管理逻辑 #

日志中的honcho start & python manage.py qcluster写法容易出问题，建议用Procfile统一管理进程：

# 项目根目录创建Procfile
web: python manage.py runserver 0.0.0.0:8000
qcluster: python manage.py qcluster

然后将启动命令改为honcho start，让honcho统一管理两个进程，避免后台运行的兼容性问题。

5. 手动进入容器排查状态 #

如果以上步骤仍未解决，启动临时容器进入内部排查：

docker-compose run --rm web-app bash

进入后执行以下命令验证状态：

• pip list：查看django、honcho是否已安装
• which honcho：检查honcho是否在系统PATH中
• python manage.py check：验证Django模块能否正常加载

内容的提问来源于stack exchange，提问作者Muhammad Fahid Farooq