Mac Ventura部署Django到Heroku时psycopg2安装失败求助

问题根源 #

你遇到的错误是psycopg2编译时找不到OpenSSL库，macOS Ventura之后，Homebrew安装的OpenSSL路径发生了变化（Apple Silicon芯片默认路径为/opt/homebrew/opt/openssl@3，Intel芯片为/usr/local/opt/openssl@3），之前设置的环境变量指向了错误路径，导致编译失败。

具体解决步骤 #

1. 确认OpenSSL的实际安装路径 #

在终端执行命令，获取当前OpenSSL的安装前缀：

brew --prefix openssl

输出示例：

• Apple Silicon: /opt/homebrew/opt/openssl@3
• Intel: /usr/local/opt/openssl@3

2. 临时设置正确的环境变量 #

根据上述输出，在终端执行对应的环境变量配置（命令自动适配芯片类型）：

export LDFLAGS="-L$(brew --prefix openssl)/lib"
export CPPFLAGS="-I$(brew --prefix openssl)/include"
export PKG_CONFIG_PATH="$(brew --prefix openssl)/lib/pkgconfig"

3. 用psycopg2-binary替代psycopg2 #

django-heroku依赖psycopg2，但psycopg2-binary是预编译版本，无需本地编译，更适合开发环境。直接执行以下命令安装：

pip install django-heroku psycopg2-binary

或者修改requirements.txt，将psycopg2替换为psycopg2-binary，再执行pip install -r requirements.txt。

4. 确保Xcode Command Line Tools已安装 #

编译依赖完整的clang环境，执行命令安装或更新：

xcode-select --install

若提示已安装，可尝试重置：

xcode-select --reset

5. 永久配置环境变量（可选） #

避免每次启动终端都手动设置，将配置添加到shell配置文件中：

• zsh（Ventura默认shell）：

  echo 'export LDFLAGS="-L$(brew --prefix openssl)/lib"' >> ~/.zshrc
  echo 'export CPPFLAGS="-I$(brew --prefix openssl)/include"' >> ~/.zshrc
  echo 'export PKG_CONFIG_PATH="$(brew --prefix openssl)/lib/pkgconfig"' >> ~/.zshrc
  

• bash：

  echo 'export LDFLAGS="-L$(brew --prefix openssl)/lib"' >> ~/.bash_profile
  echo 'export CPPFLAGS="-I$(brew --prefix openssl)/include"' >> ~/.bash_profile
  echo 'export PKG_CONFIG_PATH="$(brew --prefix openssl)/lib/pkgconfig"' >> ~/.bash_profile
  

添加后执行source ~/.zshrc或source ~/.bash_profile使配置生效。

额外说明 #

Heroku官方推荐生产环境使用psycopg2-binary（或通过Heroku Postgres插件自动处理依赖），因此开发环境使用psycopg2-binary完全不影响部署。

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