运行docker-compose up启动Django应用时出现'invalid ELF header'错误

问题详情 #

尝试用Docker部署Django项目（Docker新手），执行docker-compose up时，在RUN pip install -r requirements.txt步骤触发以下错误：

error while loading shared libraries: /usr/local/bin/../lib/libpython3.9.so.1.0: invalid ELF header

我的配置文件 #

Dockerfile

FROM python:3.9
ENV PYTHONUNBUFFERED 1
RUN mkdir /my-project
WORKDIR /my-project
ADD . /my-project/
RUN pip install -r requirements.txt

.dockerignore

# Git
.git
.gitignore

# Docker
Dockerfile
.dockerignore

# Byte-complied / optimized / DLL files
**/__pycache__/
**/*.py[cod]

# Django migrations
**/migrations/*.py
!**/migrations/__init__.py

# Swap files
**/*.swp

# venv files
venv/
.env

# Sphinx build files
docs/_*/

docker-compose.yml

version: '3'

services:
  web:
    build: .
    command: bash -c "python manage.py runserver 0.0.0.0:8000"
    container_name: my-project
    volumes:
      - .:/my-project
    ports:
      - "8000:8000"

解决方案 #

这个错误的核心是本地系统的Python相关文件（比如venv目录内的编译文件、本地Python库）侵入了容器环境，和容器内的Python运行时冲突，按以下步骤排查修复：

• 清理构建缓存：之前的构建可能因为.dockerignore规则未生效，导致缓存中混入了本地Python文件，执行命令强制重新构建：

  docker-compose build --no-cache
  

• 修复.dockerignore规则：将venv/改成**/venv/，确保所有层级的虚拟环境目录都被忽略，避免嵌套的venv被打包进镜像。
• 调整容器挂载策略：docker-compose.yml中- .:/my-project会把本地整个项目目录覆盖容器内的/my-project，包括容器自带的Python库。开发环境如需热更新，建议只挂载Django应用代码目录（比如./my_django_app:/my-project/my_django_app），而非整个根目录。

另外，优化Dockerfile可以降低这类问题的发生概率，同时提升构建效率：

FROM python:3.9
ENV PYTHONUNBUFFERED 1
WORKDIR /my-project
# 先复制依赖文件，利用Docker层缓存
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
# 最后复制项目代码
COPY . .

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