Docker+Poetry容器运行异常：全局Python致Django模块缺失

核心问题 #

容器运行时调用了全局Python解释器，未加载Poetry管理的依赖环境，导致提示找不到Django模块。

关键修复配置 #

1. Dockerfile 正确写法 #

两种方案任选其一：

方案一：禁用Poetry虚拟环境（推荐容器内使用）

直接让Poetry把依赖安装到系统Python环境，避免虚拟环境路径问题：

FROM python:3.11-slim

WORKDIR /app

# 安装Poetry
RUN pip install --no-cache-dir poetry

# 关闭虚拟环境创建
RUN poetry config virtualenvs.create false

# 复制依赖配置文件
COPY pyproject.toml poetry.lock ./

# 安装生产依赖（跳过项目根目录安装，跳过dev依赖）
RUN poetry install --no-root --no-dev

# 复制项目代码
COPY . .

# 用poetry run启动，确保依赖上下文正确
CMD ["poetry", "run", "python", "manage.py", "runserver", "0.0.0.0:8000"]

方案二：强制在项目内创建虚拟环境

如果坚持使用虚拟环境，需确保容器启动时激活环境：

FROM python:3.11-slim

WORKDIR /app

RUN pip install --no-cache-dir poetry

# 让Poetry在项目目录下创建.venv文件夹
RUN poetry config virtualenvs.in-project true

COPY pyproject.toml poetry.lock ./

RUN poetry install --no-root --no-dev

COPY . .

# 通过shell命令激活虚拟环境后启动服务
CMD ["sh", "-c", "source .venv/bin/activate && python manage.py runserver 0.0.0.0:8000"]

2. 检查pyproject.toml依赖配置 #

确保Django已被正确声明：

[tool.poetry.dependencies]
python = "^3.11"
django = "^4.2"
# 其他项目依赖...

执行poetry lock更新锁文件后再重新构建镜像。

3. docker-compose.yml 同步配置 #

确保容器启动命令与Dockerfile一致：

version: '3.8'

services:
  web:
    build: .
    command: poetry run python manage.py runserver 0.0.0.0:8000
    volumes:
      - .:/app
    ports:
      - "8000:8000"

验证步骤 #

1. 重新构建镜像，检查依赖安装日志：

docker-compose build --no-cache

确认日志中出现Installing django x.x.x的记录。

2. 进入容器验证依赖加载：

docker-compose exec web poetry run python -c "import django; print(django.__version__)"

能正常输出版本号说明依赖生效。

3. 确认Python解释器路径：

docker-compose exec web poetry run which python

若用方案二，输出应为/app/.venv/bin/python；方案一则为系统Python路径，但依赖已正确安装。

避坑提示 #

• 容器内不要手动激活虚拟环境后启动服务，需用sh -c包裹命令或者直接用poetry run。
• 先复制依赖配置文件再安装依赖，利用Docker缓存减少重复构建时间。
• 确保poetry.lock与pyproject.toml版本同步，避免依赖不一致。

内容的提问来源于stack exchange，提问作者Александр Леонидович