前言
之前不是把 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 镜像不一样的地方就很多了，太折腾了…
