Java连接MySQL需用mysql-connector-j 8.x驱动,URL必须含serverTimezone=UTC等参数;PostgreSQL需配置sslmode和currentSchema;应避免硬编码,用配置文件管理参数,并通过getConnection()验证真实连通性。

Java中配置MySQL连接:驱动、URL与常见报错
Java连接MySQL最常踩的坑是驱动版本不匹配和URL格式错误。JDBC URL必须带serverTimezone参数,否则高版本MySQL(8.0+)会因时区问题抛出java.sql.SQLException: The server time zone value '...' is unrecognized。
- 使用MySQL 8.0+时,必须引入
mysql-connector-j8.x(旧版mysql-connector-java已废弃) - JDBC URL格式:
jdbc:mysql://localhost:3306/mydb?useSSL=false&serverTimezone=UTC&allowPublicKeyRetrieval=true - 若用HikariCP等连接池,
driverClassName通常可省略(自动推断),但显式指定com.mysql.cj.jdbc.Driver更稳妥
Properties props = new Properties();
props.setProperty("url", "jdbc:mysql://localhost:3306/test?serverTimezone=UTC");
props.setProperty("username", "root");
props.setProperty("password", "pass123");
DataSource ds = new HikariDataSource(props);
Java中配置PostgreSQL连接:SSL默认行为与schema切换
PostgreSQL JDBC驱动对SSL更敏感,默认开启SSL验证,本地开发时容易卡在Connection refused或SSL error: Received fatal alert: handshake_failure。
- 本地测试建议加
sslmode=disable,生产环境再启用sslmode=require并配证书 - 若目标表不在
publicschema下(如sales.order),需在URL里加currentSchema=my_schema,否则Table not found错误不会提示schema问题 - 驱动类名始终是
org.postgresql.Driver,无版本后缀差异
String url = "jdbc:postgresql://localhost:5432/myapp?sslmode=disable¤tSchema=app_data";
DataSource ds = new HikariDataSource();
ds.setJdbcUrl(url);
ds.setUsername("appuser");
ds.setPassword("secret");
统一管理连接参数:避免硬编码与profile切换
把数据库配置写死在代码里会导致测试/生产环境切换困难,且密码明文暴露风险高。Spring Boot用户应优先用application.yml;纯Java SE项目可用resources/db.properties + System.getProperty("env", "dev")加载不同文件。
- 不要在代码里拼接
username和password——HikariCP支持dataSource.user和dataSource.password独立设置 - PostgreSQL的
databaseName参数名实际是database(URL中为路径第一段),MySQL对应的是databaseName或直接写在URL路径里,别混淆 - 连接池初始化失败时,
HikariDataSource构造会直接抛异常,而不是静默失败,要确保try-with-resources外捕获HikariPool.PoolInitializationException
验证连接是否真正生效:不只是new DataSource
很多开发者以为new HikariDataSource(props)成功就代表连上了,其实只是配置解析通过。真正校验需触发一次物理连接。
立即学习“Java免费学习笔记(深入)”;
- 调用
ds.getConnection()并立即close()是最轻量验证方式 - 若用Spring,
@PostConstruct里执行jdbcTemplate.execute("SELECT 1")比依赖spring.datasource.hikari.initialization-fail-timeout更可控 - MySQL的
autoReconnect=true已被弃用,靠连接池自身的connection-test-query或validation-timeout代替
try (Connection conn = ds.getConnection()) {
conn.createStatement().execute("SELECT 1");
System.out.println("✅ DB connection OK");
} catch (SQLException e) {
throw new RuntimeException("DB unreachable", e);
}
实际部署时,MySQL和PostgreSQL对maxLifetime、idleTimeout的合理值差异很大——PostgreSQL默认连接空闲超时是10分钟,而MySQL服务端默认是8小时,这个时间差会在连接池里引发大量Connection reset异常,不能照搬同一套配置。










