使用SQLAlchemy连接AWS RDS PostgreSQL实例时出现OperationalError故障排查请求

这个错误本质是你的本地机器和AWS RDS实例之间的网络连通性出现了问题，下面是一步步的排查和解决方法：

1. 检查RDS实例的安全组入站规则 #

AWS RDS的安全组默认拒绝所有外部访问，你需要确保安全组允许你的本地IP访问5432端口：

• 登录AWS控制台，进入RDS服务找到你的PostgreSQL实例
• 在「连接与安全性」标签下，点击关联的安全组链接
• 在安全组的「入站规则」中添加一条规则：
  • 类型：PostgreSQL（端口5432）
  • 来源：选择「我的IP」（AWS会自动识别你的公网IP），或手动输入你的公网IP（格式如x.x.x.x/32）
  • 注意：测试时可临时用0.0.0.0/0允许所有IP访问，但生产环境必须限制到特定IP，避免安全风险

2. 确认RDS实例的公有可访问性 #

如果RDS实例设置为「私有」，仅能在VPC内部访问，外部机器无法连接：

• 在RDS实例的「连接与安全性」标签下，查看「公有可访问性」选项
• 若显示为「否」，修改为「是」，等待实例状态更新为「可用」后再尝试连接

3. 测试本地到RDS的网络连通性 #

用简单命令验证网络是否能到达RDS端点：

• 用telnet测试：telnet postgres.cygbp7ngafcu.eu-central-1.rds.amazonaws.com 5432
• 或用nc命令：nc -zv postgres.cygbp7ngafcu.eu-central-1.rds.amazonaws.com 5432
• 如果命令返回「连接失败」，说明本地网络存在拦截：
  • 检查本地防火墙是否允许出站访问5432端口
  • 若使用代理，确认代理配置允许访问该RDS端点和端口
  • 尝试切换网络（比如手机热点），排除本地运营商的网络限制

4. 确认RDS实例状态和端点正确性 #

• 检查RDS实例状态是否为「可用」，如果是「正在创建」「重启中」或「维护中」，需等待状态恢复后再连接
• 再次核对连接字符串中的端点、端口、用户名和密码是否正确，尤其是端点地址要和RDS控制台显示的完全一致（注意不要多打或少打字符）

5. 检查VPC的网络ACL（如果实例在VPC内） #

如果你的RDS实例在自定义VPC中，还要检查VPC的网络ACL：

• 确保网络ACL的入站规则允许5432端口的流量，出站规则允许响应流量（通常允许所有出站即可）

按照上面的步骤逐一排查，基本就能解决这个网络连接问题了。

内容的提问来源于stack exchange，提问作者Berke Şentürk