在python:3.9-alpine中导入psycopg2失败：缺失libpq.so.5求助

问题根源 #

报错里的libpq.so.5是PostgreSQL的运行时共享库，你的Dockerfile只装了编译用的postgresql-dev，但漏掉了运行时必须的postgresql-libs包。哪怕用了psycopg2-binary预编译包，在Alpine的musl libc环境下依然依赖这个运行时库。

修复步骤 #

1. 更新Dockerfile的apk安装命令，添加postgresql-libs：

RUN apk add --no-cache gcc libffi-dev musl-dev postgresql-dev postgresql-libs make curl git python3-dev openssl-dev cargo

（注：原命令里重复写了make，可以删掉一个）

2. 可选优化：用多阶段构建缩减镜像体积
   如果不想把编译依赖留在最终镜像里，推荐用多阶段构建：

# 第一阶段：安装编译依赖，完成依赖包安装
FROM python:3.9-alpine AS builder
RUN apk add --no-cache gcc libffi-dev musl-dev postgresql-dev make python3-dev openssl-dev cargo
WORKDIR /app
COPY pyproject.toml poetry.lock ./
RUN pip install poetry && poetry install --no-root --no-dev

# 第二阶段：仅保留运行时所需内容
FROM python:3.9-alpine
RUN apk add --no-cache postgresql-libs curl git
WORKDIR /app
COPY --from=builder /root/.cache/pypoetry/virtualenvs/ /root/.cache/pypoetry/virtualenvs/
COPY . .
CMD ["python", "main.py"]

验证 #

重新构建镜像并运行，导入psycopg2时就不会再出现libpq.so.5找不到的错误了。

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