Apple M1运行Django报错：symbol not found in flat namespace '_PQbackendPID'

问题根源 #

该错误是由于预编译的psycopg2-binary包与M1芯片的arm架构PostgreSQL不兼容，或虚拟环境未正确关联Homebrew安装的PostgreSQL库导致。

方案1：替换为源码编译版psycopg2 #

预编译的psycopg2-binary多适配x86架构，M1需源码编译版本：

• 卸载现有psycopg2-binary：

  pip uninstall psycopg2-binary -y
  

• 安装Homebrew依赖（确保PostgreSQL已正常安装）：

  brew install postgresql python@3.x  # 将x替换为你的Python版本，如3.10
  

• 设置编译环境变量，让Python找到PostgreSQL库：

  export LDFLAGS="-L/opt/homebrew/opt/postgresql/lib"
  export CPPFLAGS="-I/opt/homebrew/opt/postgresql/include"
  

• 安装源码版psycopg2：

  pip install psycopg2
  

方案2：确保虚拟环境使用arm架构Python #

若虚拟环境基于Rosetta兼容的x86 Python创建，会与arm版PostgreSQL冲突：

• 检查当前Python架构：

  python -c "import platform; print(platform.machine())"
  

  若输出x86_64，说明使用的是Rosetta下的Python，需切换为arm版本。
• 用Homebrew的arm版Python重建虚拟环境：

  # 删除旧虚拟环境（假设名为myenv）
  rm -rf myenv
  # 创建新虚拟环境
  /opt/homebrew/bin/python3 -m venv myenv
  # 激活虚拟环境
  source myenv/bin/activate
  # 重新安装依赖
  pip install django psycopg2
  

方案3：重置PostgreSQL环境路径 #

确保Homebrew的PostgreSQL路径加入系统环境：

• 将PostgreSQL的bin目录添加到PATH：

  # zsh用户执行
  echo 'export PATH="/opt/homebrew/opt/postgresql/bin:$PATH"' >> ~/.zshrc
  # bash用户执行
  echo 'export PATH="/opt/homebrew/opt/postgresql/bin:$PATH"' >> ~/.bash_profile
  

• 重启终端，激活虚拟环境后重新执行makemigrations。

验证方法 #

在虚拟环境中运行以下代码，确认psycopg2能正常连接PostgreSQL：

python
>>> import psycopg2
>>> conn = psycopg2.connect("dbname=你的数据库名 user=你的用户名 password=你的密码")
>>> conn.close()

无报错则说明问题已解决，可正常执行python manage.py makemigrations。

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