跨AWS账号：EC2可CLI连接RDS但Python连接失败问题排查

核心现象总结 #

• EC2终端通过psql CLI可正常连接RDS Postgres，但Python调用psycopg2.connect触发Segmentation fault (core dumped)
• 本地通过SSHTunnelForwarder建立隧道后，psycopg2连接报超时错误
• Jupyter Notebook执行连接代码时内核直接崩溃
• 已验证安全组、SELinux、VPC路由表无明显阻塞问题

1. 修复EC2上psycopg2段错误问题 #

排查方向：libpq版本不兼容 #

Segmentation fault大多因psycopg2依赖的C库（libpq）与系统psql使用的libpq版本不匹配导致，即使psql可用，Python环境的绑定库仍可能冲突。

操作步骤：

1. 核对版本一致性

   • 终端执行psql --version，记录系统psql依赖的libpq版本（如psql (PostgreSQL) 13.11对应libpq13）
   • 查看Python环境的psycopg2绑定版本：

     import psycopg2
     print(psycopg2.__libpq_version__)
     

   • 若版本不匹配，重新安装兼容的psycopg2：
     • 卸载现有包：pip uninstall psycopg2-binary psycopg2
     • 安装编译依赖（按需选择）：

       # 基于RHEL/CentOS
       sudo yum install postgresql-devel gcc python-devel
       # 基于Debian/Ubuntu
       sudo apt-get install libpq-dev gcc python3-dev
       

     • 编译安装匹配版本：pip install psycopg2，或指定兼容的预编译包：pip install psycopg2-binary==2.9.9（适配libpq13）

2. 最简脚本测试
   创建test_conn.py验证基础连接：

   import psycopg2
   try:
       conn = psycopg2.connect(
           database="my_db",
           user="postgres",
           password="your_password",
           host="my-db.xxxxxxxxxxx.us-west-2.rds.amazonaws.com",
           port=5432
       )
       print("Connection successful")
       conn.close()
   except Exception as e:
       print(f"Error: {e}")
   

   终端执行python test_conn.py确认修复效果

2. 修复本地SSH隧道连接超时问题 #

排查方向：隧道配置逻辑错误 #

本地连接超时通常是隧道未正确映射端口，或代码未指向本地隧道入口导致流量走公网而非SSH通道。

操作步骤：

1. 修正SSHTunnelForwarder配置
   确保将本地端口映射到RDS的5432端口，且连接目标为localhost：

   from sshtunnel import SSHTunnelForwarder
   import psycopg2
   
   with SSHTunnelForwarder(
       ('ec2-xxx.us-west-2.compute.amazonaws.com', 22),
       ssh_username='ec2-user',
       ssh_pkey='/path/to/your/key.pem',
       remote_bind_address=('my-db.xxxxxxxxxxx.us-west-2.rds.amazonaws.com', 5432),
       local_bind_address=('127.0.0.1', 5432)
   ) as tunnel:
       conn = psycopg2.connect(
           database="my_db",
           user="postgres",
           password="your_password",
           host="127.0.0.1",
           port=tunnel.local_bind_port
       )
       print("Connection successful")
       conn.close()
   

2. 验证基础网络规则

   • 确认EC2安全组允许本地IP访问22端口（SSH），无需额外开放5432（隧道流量走SSH通道）
   • 检查EC2出站规则，确保允许访问RDS的5432端口（已通过psql验证，此步可快速跳过）

3. 修复Jupyter Notebook内核崩溃问题 #

排查方向：环境依赖隔离不一致 #

Jupyter内核可能使用与终端不同的Python环境，导致依赖的psycopg2版本或libpq库冲突。

操作步骤：

1. 核对Jupyter环境信息
   在Notebook中执行以下代码，对比终端的Python环境：

   import sys
   import psycopg2
   print(f"Python路径: {sys.executable}")
   print(f"Python版本: {sys.version}")
   print(f"psycopg2版本: {psycopg2.__version__}")
   print(f"libpq版本: {psycopg2.__libpq_version__}")
   

2. 切换内核并修复依赖

   • 若环境不一致，将终端使用的Python环境注册为Jupyter内核：

     python3 -m ipykernel install --user --name=my_prod_env
     

   • 在Notebook界面切换到该内核，重新安装兼容版本的psycopg2（步骤同EC2段错误修复）

额外排查点 #

• 分析核心转储文件：EC2上出现段错误时，若生成core文件，执行gdb python core.xxx查看栈轨迹，定位具体崩溃点
• 验证RDS SSL设置：若RDS强制SSL，连接时需添加sslmode='require'参数：

  conn = psycopg2.connect(..., sslmode='require')
  

• 检查系统iptables规则：执行sudo iptables -L -n，确认无系统级流量拦截规则

内容的提问来源于stack exchange，提问作者d.eng 489