无法在Python脚本中加载psycopg2模块的技术求助

问题现象 #

1. 执行pip install psycopg2-binary后返回：

Defaulting to user installation because normal site-packages is not writeable
Requirement already satisfied: psycopg2-binary in /usr/local/lib64/python3.6/site-packages (2.7.5)
但执行import psycopg2时出现错误：

File "/home/adm_bbyers6/rrd_get/scripts/postgres_crud.py", line 4, in <module>
import psycopg2
ImportError: No module named psycopg2

2. 尝试安装psycopg2（不带binary后缀）时编译失败，错误提示：

gcc -pthread -Wno-unused-result -Wsign-compare -DNDEBUG -O2 -g -pipe -Wall -Wp,-D_FORTIFY_SOURCE=2 -fexceptions -fstack-protector-strong --param=ssp-buffer-size=4 -grecord-gcc-switches -m64 -mtune=generic -D_GNU_SOURCE -fPIC -fwrapv -fPIC -DPSYCOPG_VERSION=2.9.8 (dt dec pq3 ext) -DPSYCOPG_DEBUG=1 -DPG_VERSION_NUM=90224 -DPSYCOPG_DEBUG=1 -I/usr/include/python3.6m -I. -I/usr/include -I/usr/include/pgsql/server -I/usr/include/libxml2 -c psycopg/psycopgmodule.c -o build/temp.linux-x86_64-3.6/psycopg/psycopgmodule.o -Wdeclaration-after-statement
    In file included from psycopg/psycopgmodule.c:28:0:
    ./psycopg/psycopg.h:35:20: fatal error: Python.h: No such file or directory
     #include <Python.h>
                        ^

解决方案 #

针对导入失败问题 #

• 检查Python版本匹配：确认运行脚本的Python解释器和安装psycopg2-binary的pip属于同一版本。

  • 执行which python查看脚本使用的Python路径，执行which pip查看pip对应的路径，对比是否一致。
  • 也可以在脚本开头添加代码打印当前Python路径：

    import sys
    print(sys.executable)
    

  • 如果版本不匹配，用对应版本的pip重新安装，比如：

    python3.6 -m pip install psycopg2-binary
    

• 检查用户安装路径是否被Python识别：安装时提示Defaulting to user installation，说明包可能安装在用户目录（如~/.local/lib/python3.6/site-packages），而当前Python的sys.path未包含该路径。

  • 可以在脚本中手动添加路径：

    import sys
    sys.path.append("/home/adm_bbyers6/.local/lib/python3.6/site-packages")
    

  • 或者执行python3.6 -c "import sys; print(sys.path)"查看已包含的路径，确认用户安装目录是否在其中。

针对编译psycopg2失败问题 #

• 安装Python开发包：Python.h是Python开发包的一部分，需要安装对应版本的开发包：

  • CentOS/RHEL系统：

    yum install python36-devel
    

  • Debian/Ubuntu系统：

    apt-get install python3.6-dev
    

• 安装PostgreSQL开发依赖：psycopg2编译需要PostgreSQL的库文件，安装对应开发包：

  • CentOS/RHEL系统：

    yum install postgresql-devel
    

  • Debian/Ubuntu系统：

    apt-get install libpq-dev
    

  安装完成后再尝试pip install psycopg2。

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