Windows系统Python 3.12下psycopg2导入失败问题求助

已尝试操作 #

• 卸载并清理pip缓存后重装psycopg2
• 安装psycopg2-binary包
• 更新Microsoft Visual C++组件
• 重新安装Python 3.12

额外排查与解决步骤 #

• 验证环境一致性
  在PowerShell中执行where python和where pip，确认两者均指向Python 3.12的安装目录，避免混用不同版本的Python环境。同时检查Python的Scripts目录是否已添加到系统环境变量PATH中。

• 确认psycopg2-binary版本兼容性
  执行pip show psycopg2-binary查看当前安装版本，确保该版本支持Python 3.12。若版本过旧，运行pip install --upgrade psycopg2-binary安装最新兼容版本。

• 排查缺失的DLL依赖
  找到Python安装目录下Lib\site-packages\psycopg2中的_psycopg.pyd文件，使用Visual Studio的dumpbin工具执行dumpbin /dependents _psycopg.pyd，查看具体缺失的DLL文件。
  如果发现缺失libpq.dll等PostgreSQL相关DLL，可下载对应版本的PostgreSQL二进制包，将其bin目录添加到系统PATH，或直接复制libpq.dll到Python的Scripts目录。

• 使用虚拟环境隔离依赖
  执行以下命令创建并激活虚拟环境：

  python -m venv venv
  .\venv\Scripts\Activate.ps1
  

  在虚拟环境中重新安装psycopg2-binary：pip install psycopg2-binary，之后运行脚本测试。

• 检查系统与Python架构匹配
  执行python -c "import sys; print(sys.maxsize > 2**32)"，返回True表示64位Python，False为32位。确保安装的psycopg2-binary版本与Python架构一致，若不匹配，卸载后重新安装对应架构的包。

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