Java MySQL 连接时 SSL 配置错误的解决方案-java教程-PHP中文网

Java MySQL 连接时 SSL 配置错误的解决方案

本文讲解如何解决 Java Web 应用连接 MySQL 8.0 时因默认启用 SSL 导致的 SQLNonTransientConnectionException 异常，核心是通过连接 URL 显式禁用 SSL 或正确配置信任库。

本文讲解如何解决 java web 应用连接 mysql 8.0 时因默认启用 ssl 导致的 `sqlnontransientconnectionexception` 异常，核心是通过连接 url 显式禁用 ssl 或正确配置信任库。

在使用 MySQL 8.0 及其 JDBC 驱动（mysql-connector-j 8.x）时，驱动默认强制启用 SSL/TLS 加密连接。当 GlassFish（或 Tomcat、Jetty 等容器）未配置有效的 TLS 信任库（如 keystore.jks），或该密钥库已损坏、密码错误时，就会抛出类似以下的嵌套异常：

java.sql.SQLNonTransientConnectionException: Cannot open file: .../keystore.jks [Keystore was tampered with, or password was incorrect]
Caused by: com.mysql.cj.exceptions.SSLParamsException: ...
Caused by: java.io.IOException: Keystore was tampered with, or password was incorrect

该错误并非数据库连接地址或账号密码问题，而是 SSL 握手阶段因无法加载或验证 GlassFish 自带的 JKS 文件而失败——尤其常见于开发环境（如本地 MySQL + GlassFish 7 + NetBeans 18），此时 SSL 并非必需。

✅ 推荐解决方案（开发阶段）：禁用 SSL

修改 JDBC 连接 URL，在末尾添加 ?useSSL=false 参数（注意：MySQL 8.0.23+ 已弃用 useSSL，应改用 sslMode=DISABLED，但为兼容性与清晰性，二者均列出）：

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

// ✅ 推荐（兼容 MySQL 8.0+，语义明确）
String url = "jdbc:mysql://localhost:3306/library?sslMode=DISABLED&serverTimezone=UTC";

// ⚠️ 兼容旧版写法（仍有效，但官方已标记为 deprecated）
// String url = "jdbc:mysql://localhost:3306/library?useSSL=false&serverTimezone=UTC";

Connection con = DriverManager.getConnection(url, "root", "");

? 关键补充参数说明：

serverTimezone=UTC：避免因时区不匹配导致 ResultSet 时间字段解析异常（MySQL 8.0 默认严格校验时区）；
若使用中文字符，建议额外添加 &characterEncoding=UTF-8 保证编码一致。

? 进阶方案（生产环境推荐）：启用并正确配置 SSL
若需启用 SSL（如满足安全合规要求），请执行以下步骤：

生成或获取合法的 MySQL 服务端证书（ca.pem, server-cert.pem, server-key.pem）；
将 CA 证书导入 GlassFish 的 cacerts.jks（使用 keytool -importcert）；

在连接 URL 中指定：

?sslMode=REQUIRED&trustCertificateKeyStoreUrl=file:/path/to/cacerts.jks&trustCertificateKeyStorePassword=changeit

⚠️ 重要注意事项：

❌ 切勿在生产环境长期使用 sslMode=DISABLED；
❌ 不要尝试修复或重置 GlassFish 自带的 keystore.jks —— 它专用于管理控制台 HTTPS，与数据库连接无关；
✅ 始终使用 PreparedStatement（你已做到）防止 SQL 注入；但注意：用户名/密码明文比对存在严重安全风险，应改为密码哈希（如 BCrypt）+ 盐值校验；
✅ 建议将数据库连接信息外置为 JNDI 数据源（GlassFish 管理控制台配置），而非硬编码在 Servlet 中。

总结：该异常本质是 JDBC 驱动 SSL 策略与运行环境不匹配所致。开发初期优先通过 sslMode=DISABLED 快速验证业务逻辑；后续再按需启用受信 SSL，并遵循最小权限与配置外置原则提升应用健壮性与安全性。