使用python-slim鏡像遇到無法使用PostgreSQL的問題及解決方法

更新時間：2024年08月21日 09:29:38 作者：程序設計實驗室

這篇文章主要介紹了使用python-slim鏡像遇到無法使用PostgreSQL的問題及解決方法,本文給大家介紹的非常詳細,感興趣的朋友跟隨小編一起看看吧

前言

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

一開始demo部署是使用 SQLite 數(shù)據(jù)庫的，用著沒問題，但很快切換到 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

好的，經(jīng)常被 docker 坑的人應該已經(jīng)看出問題出在系統(tǒng)環(huán)境上了

不使用 slim 鏡像換成普通的 python 鏡像就正常了…

解決

OK，既然找出問題原因，那么就可以來著手解決了。

使用 psycopg2-binary

最簡單的方法就是將 psycopg2 庫換成 psycopg2-binary，這是一個預編譯的 psycopg2 包，不需要編譯環(huán)境，安裝更簡便。

手動安裝 libpq 庫

既然缺了 libpq 庫，那就在 docker 鏡像里安裝。

這個方法我還沒測試，又麻煩又不優(yōu)雅

# 使用 Python 3.11 slim 基礎鏡像
FROM python:3.11-slim
# 安裝 psycopg2 依賴
RUN apt-get update && apt-get install -y \
    libpq-dev \
    gcc \
    # 清理緩存以減少鏡像大小
    && apt-get clean \
    && rm -rf /var/lib/apt/lists/*