使用python-slim镜像遇到无法使用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 update && apt-get install -y \
libpq-dev \
gcc \
# 清理缓存以减少镜像大小
&& apt-get clean \
&& rm -rf /var/lib/apt/lists/*
不同的python基础镜像#
python镜像基于 Debian 系统,默认是用 Debian 的最新稳定版,也可以自己指定版本,比如 python3.11-slim-bookworm
就是指定用 Debian 12 ("bookworm") 作为基础镜像
- python3.11-slim-bookworm 基础镜像打包出来的镜像大小是424MB,python3.11-slim 打包出来也是这个大小
- 使用 python3.11 基础镜像打包出来就到 1.3G 了,大小直接翻了几倍
还可以选择 alpine 镜像,不过可能会遇到更多兼容性问题,我就不折腾了,心累。
小结#
一般选 slim 镜像还是可以的,基于 Debian 不怎么需要担心兼容性问题
偶尔遇到小问题还是比较好解决的
alpine 镜像不一样的地方就很多了,太折腾了…
作者:DealiAxy
出处:https://www.cnblogs.com/deali/p/18369637
版权:本作品采用「署名-非商业性使用-相同方式共享 4.0 国际」许可协议进行许可。
微信公众号:「程序设计实验室」
新版StarBlog已经上线,地址:http://blog.deali.cn
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】凌霞软件回馈社区,博客园 & 1Panel & Halo 联合会员上线
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】博客园社区专享云产品让利特惠,阿里云新客6.5折上折
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步
· Deepseek官网太卡,教你白嫖阿里云的Deepseek-R1满血版
· 2分钟学会 DeepSeek API,竟然比官方更好用!
· .NET 使用 DeepSeek R1 开发智能 AI 客户端
· DeepSeek本地性能调优
· 一文掌握DeepSeek本地部署+Page Assist浏览器插件+C#接口调用+局域网访问!全攻略