使用python-slim镜像遇到无法使用PostgreSQL的问题及解决方法

时间：2024-09-22 15:17:09|栏目：PostgreSQL|点击：次

前言

之前不是把 DjangoStarter 的 docker 方案重新搞好了吗

一开始demo部署是使用 SQLite 数据库的，用着没问题，但很快切换到 PostgreSQL 的时候就遇到问题了…

报错

docker 启动之后，app 容器报错

django.core.exceptions.ImproperlyConfigured: Error loading psycopg2 or psycopg module

排错

一开始我还以为是 psycopg2 库装不上，或者是在 python_builder 阶段的依赖没有正确复制到 final 阶段的容器，但后面改了几个地方，重新试了一下都不行。

接下来使用 python src/manage.py shell 进入 shell，测试一下能否导入 psycopg2 库

>>> import psycopg2
Traceback (most recent call last):
  File "<console>", line 1, in <module>
  File "/project/.venv/lib/python3.11/site-packages/psycopg2/__init__.py", line 51, in <module>
    from psycopg2._psycopg import (                     # noqa
ImportError: libpq.so.5: cannot open shared object file: No such file or directory

好的，经常被 docker 坑的人应该已经看出问题出在系统环境上了

不使用 slim 镜像换成普通的 python 镜像就正常了…

解决

OK，既然找出问题原因，那么就可以来着手解决了。

使用 psycopg2-binary

最简单的方法就是将 psycopg2 库换成 psycopg2-binary，这是一个预编译的 psycopg2 包，不需要编译环境，安装更简便。

手动安装 libpq 库

既然缺了 libpq 库，那就在 docker 镜像里安装。

这个方法我还没测试，又麻烦又不优雅

# 使用 Python 3.11 slim 基础镜像
FROM python:3.11-slim
# 安装 psycopg2 依赖
RUN apt-get ｕｐｄａｔｅ && apt-get install -y \
    libpq-dev \
    gcc \
    # 清理缓存以减少镜像大小
    && apt-get clean \
    && rm -rf /var/lib/apt/lists/*