本地Spring Boot连接Amazon RDS PostgreSQL报超时如何排查

现有配置存在的问题 #

你的application.properties存在2处明确问题：

• 账号密码配置值带前置空格：spring.datasource.username、spring.datasource.password两个配置项的等号后多打了空格，Spring读取配置时会将空格计入账号、密码的实际值，直接触发鉴权失败，这类数据库连接阶段的失败会连带抛出Error creating bean with name 'entityManagerFactory'的Bean初始化错误。
• 缺少连接超时配置：JDBC连接串未配置超时参数，网络不通时请求会长时间阻塞，最终卡在JPA初始化阶段抛出非根因的Bean创建报错，增加排查难度。

修正后的基础配置参考如下：

# 注意配置项等号后的值不要加多余前置/后置空格
spring.datasource.url=jdbc:postgresql://替换为你的RDS端点:5432/替换为你的数据库名?connectTimeout=10&socketTimeout=30
spring.datasource.driver-class-name=org.postgresql.Driver
spring.datasource.username=替换为你的数据库用户名
spring.datasource.password=替换为你的数据库密码

spring.jpa.hibernate.ddl-auto=update
# 可选：连接池超时配置，避免无效连接阻塞服务启动
spring.datasource.hikari.connection-timeout=10000
spring.datasource.hikari.validation-timeout=3000

connect timed out 报错排查修复步骤 #

连接超时属于网络层连通性故障，按以下顺序排查，不要先纠结Spring、JPA相关配置：

• 先做基础连通性校验：本地执行nc -zv 你的RDS端点 5432（Windows系统可执行telnet 你的RDS端点 5432），如果命令返回连接失败，说明网络根本没通，和应用配置无关。
• 检查RDS安全组规则：RDS绑定的安全组入站规则必须放通你本地当前的公网IP到5432端口的访问权限，不要配置0.0.0.0/0全量放行避免安全风险。注意家庭宽带的公网IP会在路由重启后变动，连不上时优先核对当前公网IP和安全组配置的IP是否一致。
• 检查RDS网络访问配置：如果RDS部署在自定义VPC内，需要在实例配置中开启「公开可访问」开关，同时确认VPC关联的路由表存在指向互联网网关的路由；如果RDS为私有部署模式（未开启公网访问），本地无法直接连接端点，需要通过VPN、跳板机端口转发的方式打通网络后再连接。
• 排查本地网络限制：确认本地防火墙、公司内网策略没有拦截出站5432端口的请求，可临时切换手机热点测试，排除本地网络拦截的问题。
• 核对RDS实例运行状态：在RDS控制台确认实例处于「运行中」状态，不存在存储占满、CPU打满、维护重启、连接数达上限的异常情况。
• 次生报错说明：Error creating bean with name 'entityManagerFactory'是数据库连接失败后的连带报错，只要网络连通、账号密码及库权限配置正确，该报错会自动消失。如果连通后仍报该错，再检查PostgreSQL驱动版本和RDS实例版本是否匹配、实体类与表结构的映射关系是否正确即可。

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