RHEL 7虚拟机安装psycopg2时gcc命令执行失败报错如何解决？

问题根因 #

报错核心原因是缺少Python3.6的开发头文件，psycopg2从源码编译时需要调用Python.h文件，该文件默认不包含在RHEL7的标准Python3.6运行环境中。

解决步骤 #

• 安装Python3.6开发包
  执行命令：

sudo yum install python36-devel

安装完成后Python.h会被自动放到gcc可识别的系统头文件路径下。

• 补全编译基础工具（若未安装）
  执行命令：

sudo yum groupinstall "Development Tools"

确保gcc、make等编译所需的基础工具组件完整。

• 重新安装psycopg2
  执行命令：

python -m pip install psycopg2

补充说明 #

如果执行上述步骤后仍有报错，可以先安装wheel包优化安装流程：

pip install wheel

再重新执行psycopg2的安装命令即可。生产环境推荐使用源码编译的psycopg2包，兼容性优于psycopg2-binary，适配SQLAlchemy等上层依赖不会出现兼容性问题。

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