创建PostgreSQL连接时遭遇psycopg2 ImportError问题求助

问题根源 #

回退PostgreSQL从14到13后，psycopg2（包括binary版本）是基于旧的PostgreSQL 14的libpq.5.dylib编译的，而PostgreSQL 13的libpq库路径/版本文件名不匹配，导致动态链接器找不到指定的库文件。M1芯片的macOS因架构差异，这类路径依赖问题会更突出。

解决方案 #

方案1：创建软链接映射到当前PostgreSQL 13的libpq库 #

• 先定位PostgreSQL 13的libpq路径，brew安装的M1 macOS通常为/opt/homebrew/opt/postgresql@13/lib/，查看该目录下的libpq文件：

  ls /opt/homebrew/opt/postgresql@13/lib/libpq*.dylib
  

• 如果目标路径/opt/homebrew/opt/postgresql/lib/不存在，先创建：

  mkdir -p /opt/homebrew/opt/postgresql/lib/
  

• 创建软链接，假设PostgreSQL 13的libpq文件为libpq.5.13.dylib，将其链接为报错中要求的libpq.5.dylib：

  ln -s /opt/homebrew/opt/postgresql@13/lib/libpq.5.13.dylib /opt/homebrew/opt/postgresql/lib/libpq.5.dylib
  

  若PostgreSQL 13目录下直接存在libpq.5.dylib，则直接链接该文件即可。

方案2：重新编译psycopg2绑定当前PostgreSQL 13环境 #

• 卸载已安装的psycopg2相关包：

  pip uninstall -y psycopg2 psycopg2-binary
  

• 加载PostgreSQL 13的环境变量，确保编译时能找到正确的库和头文件：

  export PATH="/opt/homebrew/opt/postgresql@13/bin:$PATH"
  export LDFLAGS="-L/opt/homebrew/opt/postgresql@13/lib"
  export CPPFLAGS="-I/opt/homebrew/opt/postgresql@13/include"
  

• 从源码编译安装psycopg2，强制使用当前系统的PostgreSQL环境：

  pip install psycopg2 --no-binary :all:
  

方案3：设置环境变量指定库路径 #

• 临时设置环境变量，在运行Python脚本前执行：

  export DYLD_LIBRARY_PATH="/opt/homebrew/opt/postgresql@13/lib:$DYLD_LIBRARY_PATH"
  python your_script.py
  

• 若想永久生效，将环境变量添加到shell配置文件（如~/.zshrc或~/.bashrc）：

  echo 'export DYLD_LIBRARY_PATH="/opt/homebrew/opt/postgresql@13/lib:$DYLD_LIBRARY_PATH"' >> ~/.zshrc
  source ~/.zshrc
  

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