Spring Boot JPA本地可连Azure PostgreSQL 部署App Service连接失败

该故障的核心触发点是Azure App Service到Azure Database for PostgreSQL的网络链路不通，其余报错均为该问题的连锁反应：

• Hikari池连接超时、PSQLException是网络不通的直接表现
• Hibernate找不到方言、entityManagerFactory创建失败，是因为无法连上数据库拉取元数据导致的次生错误
• 80端口健康检查失败是Spring上下文初始化终止、Tomcat未正常启动的最终结果
  本地运行可正常连通，是因为本地客户端公网IP已经被加入PostgreSQL防火墙允许列表，但App Service的出站IP不在允许范围内，也没有配置对应的网络访问权限。

1. 配置PostgreSQL访问权限（必做） #

进入目标PostgreSQL实例的连接安全配置页，二选一配置即可：

• 快速验证方案：打开「允许Azure服务和资源访问此服务器」开关，保存配置后等待规则生效（约1-2分钟）。该选项会放行所有Azure公有云内合规服务的访问请求，适合测试环境快速排障
• 最小权限方案：到目标App Service的「属性」页面，复制所有列出的出站公网IP，逐个添加到PostgreSQL的防火墙允许规则中，保存后生效。该方案仅放行业务所需的App Service访问，适合生产环境

2. 优化JPA启动配置（必做，避免偶发启动失败） #

不要依赖Hibernate自动探测数据库方言，在应用配置文件（application.properties/yml）中手动指定方言，同时调整连接池超时参数适配云环境网络冷启动延迟：

# 手动指定PostgreSQL方言，无需连接库探测
spring.jpa.database-platform=org.hibernate.dialect.PostgreSQLDialect
# 调整Hikari连接超时配置，适配云环境网络握手延迟
spring.datasource.hikari.connection-timeout=30000
spring.datasource.hikari.initialization-fail-timeout=60000
# 保持Azure PostgreSQL要求的SSL连接配置，不要关闭
spring.datasource.ssl-mode=require

3. （生产环境可选）虚拟网络专属链路配置 #

如果需要更高等级的网络安全，不暴露数据库公网入口，可做以下配置：

• 将PostgreSQL配置为虚拟网络访问模式，开启对应子网的Microsoft.DBforPostgreSQL服务端点
• 在App Service网络配置中开启出站虚拟网络集成，绑定和PostgreSQL相同的虚拟网络子网
• 关闭PostgreSQL的公网访问权限，仅允许虚拟网络内资源访问

4. 重新部署验证 #

执行部署命令重新发布应用：
mvn azure-webapp:deploy
部署后查看App Service日志流，确认HikariPool初始化成功、无连接超时报错，且80端口健康检查可正常响应即修复完成。

• 不要在应用配置中添加本地开发用的网络代理配置，App Service访问同云资源不需要走代理
• 不要随意关闭PostgreSQL的SSL连接要求，Azure PostgreSQL默认强制SSL连接，关闭后会直接被服务端拒绝连接
• 如果配置完防火墙后依然超时，检查App Service是否配置了自定义的出站网络规则（比如NAT网关、防火墙策略）拦截了到PostgreSQL 5432端口的请求

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