在树莓派2部署Cookiecutter-Django时Psycopg依赖安装失败求助

核心原因 #

树莓派2采用ARMv7架构，搭配的Raspbian 11（bullseye）系统库版本较旧，确实会和Psycopg 3.x系列存在兼容性问题：

• Psycopg 3的psycopg-binary预编译包通常仅提供主流ARM64（aarch64）架构支持，对ARMv7的预编译包维护不足，导致构建时找不到匹配版本。
• Raspbian 11自带的libpq版本为13.x，而Psycopg 3.1.x可能要求更高版本的libpq，仅安装libpq5（运行时库）无法满足纯Python安装的编译依赖需求。

具体解决方案 #

方案1：降级到Psycopg2（最稳妥）

Django 4.2同时支持Psycopg2和Psycopg3，而Psycopg2对ARMv7和Raspbian 11的支持更成熟：

1. 修改项目的requirements/production.txt（或对应依赖文件），将psycopg-binary==3.1.17替换为：

   psycopg2-binary==2.9.9
   

2. 重新构建容器栈，这个版本的预编译包完全支持ARMv7架构。

方案2：正确配置Psycopg3的纯Python安装

如果坚持使用Psycopg3，需要在Dockerfile中补充完整的编译依赖，而非仅安装libpq5：

1. 在Dockerfile的系统依赖安装段添加编译工具和libpq开发包：

   RUN apt-get update && apt-get install -y --no-install-recommends \
       libpq-dev \
       gcc \
       python3-dev \
       && rm -rf /var/lib/apt/lists/*
   

2. 将依赖中的psycopg-binary替换为纯Python版本的psycopg：

   psycopg==3.1.17
   

   纯Python版本会基于系统的libpq编译适配层，解决架构匹配问题。

方案3：升级系统或调整基础镜像

• 如果条件允许，将树莓派的系统升级到Raspbian 12（bookworm），其自带的libpq版本为15.x，完全满足Psycopg3.1.x的要求，预编译包的支持也更完善。
• 调整Docker基础镜像为和Raspbian 11匹配的python:3.11-slim-bullseye（对应项目使用的Python版本），避免跨系统库版本的冲突。

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