M1芯片Mac运行Django连PostgreSQL时psycopg2报libpq.5.dylib缺失错误

该报错是Apple Silicon架构Mac设备特有的路径兼容问题，核心原因有两个：

• Intel芯片Mac的Homebrew默认路径为/usr/local，但M1芯片Mac的Homebrew路径改为/opt/homebrew，你之前安装的psycopg2编译时绑定了Homebrew版本PostgreSQL的库路径，但你实际使用的是Postgres.app安装的PostgreSQL，二者库文件路径不匹配，导致程序加载时找不到对应的依赖库。
• 你之前创建软链失效是因为路径指向错误，Postgres.app的默认库文件路径为/Applications/Postgres.app/Contents/Versions/13/lib/，并非官网pkg安装包对应的/Library/PostgreSQL/13/路径，自然无法匹配到有效文件。

通用修复步骤 #

1. 先激活项目虚拟环境，卸载已安装的失效psycopg2相关包：
   pip uninstall -y psycopg2 psycopg2-binary

2. 配置临时环境变量，指定绑定你当前使用的Postgres.app的库路径：

export LDFLAGS="-L/Applications/Postgres.app/Contents/Versions/13/lib"
export CPPFLAGS="-I/Applications/Postgres.app/Contents/Versions/13/include"

3. 重新编译安装psycopg2，跳过本地缓存避免复用旧的编译文件：
   pip install psycopg2 --no-cache-dir

备选快速方案 #

如果编译安装仍有问题，可直接安装适配M1架构的预编译二进制包，不需要依赖本地PostgreSQL库：
pip install psycopg2-binary --no-cache-dir

验证方法 #

执行命令python -c "import psycopg2"，无报错即为修复完成。

注意：不要同时安装psycopg2和psycopg2-binary，会出现依赖冲突；如果后续升级Postgres.app大版本，将上述命令中的版本号13替换为对应版本号，重新安装一次psycopg2即可。

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