【JDBC-54.1】MySQL JDBC连接字符串常用参数详解

news2025/4/15 19:05:48

在Java应用程序中连接MySQL数据库时，JDBC连接字符串是建立连接的关键。一个配置得当的连接字符串不仅能确保连接成功，还能优化性能、增强安全性并处理各种连接场景。本文将深入探讨MySQL JDBC连接字符串的常用参数及其最佳实践。

1. 基本连接字符串格式

MySQL JDBC连接的基本格式如下：

jdbc:mysql://[host][:port]/[database][?propertyName1=propertyValue1[&propertyName2=propertyValue2]...]

示例：

String url = "jdbc:mysql://localhost:3306/mydb?user=root&password=123456";

2. 常用参数详解

2.1 基础连接参数

user：数据库用户名
password：数据库密码
autoReconnect：连接丢失时是否自动重连（建议设为true）
```
jdbc:mysql://localhost:3306/mydb?autoReconnect=true
```
failOverReadOnly：故障转移后是否设置为只读（默认为true）

2.2 连接池和性能优化参数

useSSL：是否使用SSL加密连接（生产环境建议设为true）
```
jdbc:mysql://localhost:3306/mydb?useSSL=true
```

serverTimezone：设置服务器时区（避免时区问题）

jdbc:mysql://localhost:3306/mydb?serverTimezone=Asia/Shanghai

useCompression：启用压缩传输（网络带宽有限时有用）
```
jdbc:mysql://localhost:3306/mydb?useCompression=true
```
cachePrepStmts：缓存预处理语句（提高性能）
```
jdbc:mysql://localhost:3306/mydb?cachePrepStmts=true
```
prepStmtCacheSize：预处理语句缓存大小（默认25）
```
jdbc:mysql://localhost:3306/mydb?prepStmtCacheSize=250
```
prepStmtCacheSqlLimit：可缓存的SQL最大长度（默认256）
```
jdbc:mysql://localhost:3306/mydb?prepStmtCacheSqlLimit=2048
```

2.3 连接超时和验证参数

connectTimeout：连接超时时间（毫秒）

jdbc:mysql://localhost:3306/mydb?connectTimeout=30000

socketTimeout：socket操作超时时间（毫秒）

jdbc:mysql://localhost:3306/mydb?socketTimeout=60000

validationQuery：连接验证查询（通常为"SELECT 1"）

jdbc:mysql://localhost:3306/mydb?validationQuery=SELECT%201

testOnBorrow：从池中获取连接时是否验证（建议true）
```
jdbc:mysql://localhost:3306/mydb?testOnBorrow=true
```

2.4 字符编码参数

useUnicode：是否使用Unicode字符集

characterEncoding：指定字符编码

jdbc:mysql://localhost:3306/mydb?useUnicode=true&characterEncoding=UTF-8

2.5 高可用和集群参数

failOverReadOnly：故障转移后是否设置为只读
autoReconnect：自动重新连接

retriesAllDown：所有服务器都不可用时的重试次数

jdbc:mysql://host1:3306,host2:3306/mydb?autoReconnect=true&failOverReadOnly=false

3. 完整示例

String url = "jdbc:mysql://localhost:3306/mydb" +
             "?user=dbuser" +
             "&password=dbpass" +
             "&useSSL=true" +
             "&serverTimezone=UTC" +
             "&autoReconnect=true" +
             "&useUnicode=true" +
             "&characterEncoding=UTF-8" +
             "&cachePrepStmts=true" +
             "&prepStmtCacheSize=250" +
             "&prepStmtCacheSqlLimit=2048" +
             "&connectTimeout=3000" +
             "&socketTimeout=60000";