JDBC PostgreSQL 连接 URL 参数详解指南
一、什么是 JDBC PostgreSQL 连接 URL?
JDBC(Java Database Connectivity)是 Java 应用连接数据库的标准 API。PostgreSQL 的官方 JDBC 驱动(org.postgresql.Driver)通过 URL 格式指定数据库连接信息,其基本结构为:
jdbc:postgresql://[host][:port]/[database][?parameter1=value1[¶meter2=value2]...]
例如:
jdbc:postgresql://localhost:5432/insurance_db?user=postgres&password=secret&sslmode=require
注意:推荐使用最新稳定版驱动:
org.postgresql:postgresql:42.7.3+(截至 2025 年)。驱动类名始终为org.postgresql.Driver(无需更改),PostgreSQL 默认端口为5432。
二、连接 URL 参数分类详解
PostgreSQL JDBC 参数可按功能分为以下六大类:
| 分类 | 作用 | 典型参数 |
|---|---|---|
| 1. 基础连接参数 | 指定数据库地址、端口、数据库名、认证信息 | host, port, database, user, password |
| 2. 编码与字符集参数 | 避免乱码,支持 Unicode(UTF-8) | currentSchema, client_encoding |
| 3. 安全与 SSL 参数 | 控制加密连接、证书验证、身份认证 | sslmode, sslcert, sslkey, sslrootcert |
| 4. 性能与连接优化 | 提升连接效率、减少延迟、避免超时 | connectTimeout, socketTimeout, prepareThreshold, binaryTransfer |
| 5. 时区与时间处理 | 避免 Java 与 PostgreSQL 时间不一致 | timezone |
| 6. 高级行为控制 | 控制事务、日志、查询行为、扩展功能 | autoCommit, binaryTransfer, logLevel, reWriteBatchedInserts |
重要提示: PostgreSQL JDBC 驱动不支持
characterEncoding参数(与 MySQL 不同),而是通过client_encoding或数据库默认编码控制。PostgreSQL 默认使用 UTF-8,通常无需显式设置编码,但仍建议显式配置以确保一致性。

