为何需在连接独立PostgreSQL容器的Django后端容器中安装PostgreSQL？

明明Django应用是连接运行在独立容器中的PostgreSQL数据库，为什么还要在Django后端容器的Dockerfile里安装PostgreSQL作为系统依赖？以下是我使用的配置文件：

Dockerfile #

# pull official base image
FROM python:3.12.4-slim-bookworm

# set working directory
WORKDIR /usr/src/app

# set environment variables
ENV PYTHONDONTWRITEBYTECODE 1
ENV PYTHONUNBUFFERED 1

# new
# install system dependencies
RUN apt-get update \
  && apt-get -y install gcc postgresql \
  && apt-get clean

# install dependencies
RUN pip install --upgrade pip
COPY ./requirements.txt .
RUN pip install -r requirements.txt

# add app
COPY . .

docker-compose.yml #

services:
  movies:
    build: ./app
    command: python manage.py runserver 0.0.0.0:8000
    volumes:
      - ./app/:/usr/src/app/
    ports:
      - 8009:8000
    env_file:
      - ./app/.env.dev
    depends_on:
      - movies-db
  movies-db:
    image: postgres:16
    volumes:
      - postgres_data:/var/lib/postgresql/data/
    environment:
      - POSTGRES_USER=movies
      - POSTGRES_PASSWORD=movies
      - POSTGRES_DB=movies_dev

volumes:
  postgres_data:

核心原因：满足psycopg2的编译依赖 #

Django连接PostgreSQL依赖psycopg2这个驱动包。如果你的requirements.txt里用的是标准的psycopg2（而非预编译的psycopg2-binary），pip安装时需要编译源码，这时候必须依赖PostgreSQL的客户端开发库（比如头文件、链接库）。

• 你Dockerfile里安装的postgresql包，会提供这些编译必需的文件；同时安装的gcc是编译源码的工具。
• 这里安装PostgreSQL不是为了在Django容器里运行数据库服务器，只是为了让psycopg2能顺利编译安装，保证Django能正常连接外部的PostgreSQL容器。

优化建议 #

其实不需要安装完整的postgresql包，只需要安装轻量的libpq-dev即可（它只包含PostgreSQL客户端开发所需的库和头文件），这样能减小镜像体积：

RUN apt-get update \
  && apt-get -y install gcc libpq-dev \
  && apt-get clean

内容的提问来源于stack exchange，提问作者Moisés Galván Niño