本文旨在帮助开发者解决Spring Boot应用通过JDBC连接Azure PostgreSQL数据库时遇到的连接失败问题。通过分析常见的配置错误和网络问题，提供一系列排查和解决问题的步骤，包括检查数据库连接字符串、防火墙设置、SSL配置以及必要的服务器重启操作。最终，帮助开发者成功建立与Azure PostgreSQL数据库的稳定连接。
在Spring Boot应用中连接Azure PostgreSQL数据库时，可能会遇到org.postgresql.util.PSQLException: The connection attempt failed. 异常。这通常表明应用程序无法与数据库建立连接。以下提供一系列排查和解决此问题的步骤：
1. 检查数据库连接配置
首先，仔细检查 application.yml 或 application-uat.yml 文件中的数据库连接配置。确保以下配置正确无误：
-
URL: jdbc:postgresql://
: / ?sslmode=require&sslfactory=org.postgresql.ssl.NonValidatingFactory : 替换为Azure PostgreSQL服务器的完全限定域名（FQDN）。 : 替换为PostgreSQL服务器的端口号（默认为5432）。 : 替换为要连接的数据库名称。 - sslmode=require: 强制使用SSL连接。
- sslfactory=org.postgresql.ssl.NonValidatingFactory: 禁用SSL证书验证。生产环境中强烈建议使用 org.postgresql.ssl.DefaultHostnameVerifier 进行证书验证，以确保安全性。
- username: 数据库用户名。
- password: 数据库密码。
示例配置 (application.yml):
spring:
datasource:
url: jdbc:postgresql://test-invoicing-db.postgres.database.azure.com:5432/postgres?sslmode=require&sslfactory=org.postgresql.ssl.NonValidatingFactory
username: "${DATABASE_USER}"
password: "${DATABASE_PASS}"
platform: postgres
initialization-mode: always注意： 使用环境变量（如 ${DATABASE_USER} 和 ${DATABASE_PASS}）是一种良好的实践，可以避免将敏感信息直接硬编码在配置文件中。
2. 网络连通性测试
使用 ping 命令或 telnet 命令测试服务器与Azure PostgreSQL服务器之间的网络连通性。
-
Ping: ping
(例如: ping test-invoicing-db.postgres.database.azure.com) -
Telnet: telnet
(例如: telnet test-invoicing-db.postgres.database.azure.com 5432)
如果 ping 命令无法解析主机名，则可能是DNS解析问题。如果 telnet 命令无法连接到端口，则可能是防火墙阻止了连接。
3. Azure防火墙规则
确保Azure PostgreSQL服务器的防火墙规则允许来自应用程序服务器的IP地址或IP地址范围的连接。可以在Azure门户中配置防火墙规则。
- 登录 Azure 门户。
- 导航到你的 Azure Database for PostgreSQL 服务器。
- 在“安全性”部分，选择“连接安全性”。
- 添加客户端 IP 地址或 IP 地址范围到防火墙规则。
4. SSL配置
Azure PostgreSQL 默认强制使用 SSL 连接。确保JDBC连接字符串包含 sslmode=require 参数。如果遇到SSL证书验证问题，可以尝试使用 sslfactory=org.postgresql.ssl.NonValidatingFactory 禁用证书验证（仅用于开发环境）。
生产环境SSL配置：
建议下载Azure PostgreSQL服务器的SSL证书，并在JDBC连接字符串中指定证书路径。
System.setProperty("javax.net.ssl.trustStore", "/path/to/your/server.crt");
System.setProperty("javax.net.ssl.trustStorePassword", "your_truststore_password");然后在JDBC URL中指定:
jdbc:postgresql://: / ?sslmode=verify-ca&sslrootcert=/path/to/your/server.crt
5. 数据库用户权限
确保数据库用户具有连接到数据库和执行所需操作的权限。
6. 依赖项检查
确认 pom.xml 或 build.gradle 文件中包含 PostgreSQL JDBC 驱动程序的依赖项。
org.postgresql postgresql 42.2.5
7. 重启服务器
有时候，Azure PostgreSQL服务器可能需要重启才能解决连接问题。可以在Azure门户中重启服务器。
8. 错误日志分析
仔细查看应用程序的错误日志，以获取更详细的错误信息。例如，java.net.UnknownHostException 表示无法解析主机名，而 PSQLException: The connection attempt failed. 可能有多种原因，需要结合其他信息进行分析。
总结：
连接Azure PostgreSQL数据库时遇到问题，需要从配置、网络、安全和权限等多个方面进行排查。按照上述步骤逐步检查，通常可以找到问题的根源并解决它。在生产环境中，务必确保使用安全的SSL配置，并定期检查服务器的健康状况。 如果问题仍然存在，可以考虑联系Azure支持或查阅PostgreSQL官方文档。
