Docker部署Django项目报错：pg_config可执行文件未找到

核心错误点 #

• 包管理器混用：你的基础镜像是Debian系的slim-buster，却使用了Alpine Linux专属的apk命令，Debian系统对应的包管理器是apt-get，这是触发报错的核心原因。
• 冗余操作与依赖顺序错误：多次重复执行pip install -r requirements.txt，且在未安装编译依赖的情况下提前尝试安装psycopg2，后续还执行了无效的apk del build-deps命令。

修复后的Dockerfile #

FROM python:3.8.13-slim-buster
WORKDIR /app

# 安装Debian系统依赖（psycopg2编译与运行所需）
RUN apt-get update && \
    apt-get install -y --no-install-recommends gcc libpq-dev && \
    rm -rf /var/lib/apt/lists/*

# 优先复制依赖文件，利用Docker缓存机制
COPY ./my_app/requirements.txt .
RUN pip install --upgrade pip --no-cache-dir && \
    pip install -r requirements.txt --no-cache-dir && \
    # 清理编译依赖，压缩镜像体积
    apt-get purge -y gcc libpq-dev && \
    apt-get autoremove -y --purge

# 复制项目代码
COPY ./my_app ./

CMD ["python3", "manage.py", "runserver", "0.0.0.0:8000"]
# CMD ["gunicorn", "main_app.wsgi:application", "--bind", "0.0.0.0:8000"]

关键优化说明 #

• 系统适配：统一使用Debian的apt-get命令管理系统依赖，匹配基础镜像的操作系统。
• 缓存优化：先复制requirements.txt再安装依赖，后续仅修改项目代码时，无需重新安装所有依赖，加快构建速度。
• 依赖清理：安装完Python依赖后，立即移除编译所需的gcc、libpq-dev等工具，大幅减小最终镜像的体积。
• 冗余移除：删除重复的pip install命令，简化构建流程。

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