MySQL客户端强制启用TLS需显式指定--ssl-mode=REQUIRED(5.7.11+/8.0+),老版本用--ssl;校验证书需--ssl-ca,VERIFY_IDENTITY还校验主机名;配置文件中[client]段设置并chmod 600;服务端须开启require_secure_transport=ON防降级。

MySQL客户端连接时如何强制启用TLS加密
不加配置的 mysql 命令默认走明文,哪怕服务端已支持TLS,客户端也不会自动用。必须显式要求,否则密码、SQL内容全在裸奔。
- 连接时加
--ssl-mode=REQUIRED是最简方式,适用于5.7.11+ 和 8.0+;老版本用--ssl(但不校验证书) - 若要校验服务端证书真实性,得配
--ssl-ca=/path/to/ca.pem;只信指定CA签发的证书,防中间人 -
--ssl-mode=VERIFY_IDENTITY会额外检查服务端证书里的主机名是否匹配连接目标,适合生产环境,但DNS或IP直连时容易失败 - MySQL 8.0.22+ 支持
--ssl-fips-mode,仅当系统开启FIPS模式时才允许连接,合规场景才需要
my.cnf里怎么持久化TLS连接配置
每次敲一长串参数太累,且应用代码(如Python的 pymysql、Go的 mysql 驱动)往往读不到命令行参数,得靠配置文件或DSN。
- 在
~/.my.cnf或/etc/my.cnf的[client]段写:[client] ssl-mode = REQUIRED ssl-ca = /etc/mysql/ssl/ca.pem ssl-cert = /etc/mysql/ssl/client-cert.pem ssl-key = /etc/mysql/ssl/client-key.pem
- 注意:
ssl-mode=DISABLED会覆盖其他SSL选项,别误加 - 配置文件权限必须是600(
chmod 600 ~/.my.cnf),否则MySQL客户端直接忽略整个文件,且不报错 - 如果服务端没开
require_secure_transport=ON,客户端即使配了TLS,仍可能降级到非加密连接——这点常被忽略
连接失败常见报错和对应解法
TLS连接失败不报“加密失败”,而是抛一堆看着像权限或网络的错误,容易绕晕。
面向 CRM 系统的 MySQL 8 数据库模式设计。当用户需要为客户关系管理(CRM)系统设计、评审、优化或生成数据库模式时,应使用此项技能。
-
SSL connection error: protocol version mismatch→ 客户端和服务端TLS版本不兼容,比如服务端只支持TLSv1.2,而旧版客户端默认用TLSv1;升级客户端或加--tls-version=TLSv1.2 -
SSL error: Unable to get certificate from client→ 客户端证书路径错、权限不足,或私钥密码未提供(mysql不支持带密码的PKCS#8私钥) -
Access denied for user ... (using password: YES)却确定密码没错 → 很可能是服务端设置了REQUIRE X509或REQUIRE SUBJECT,但客户端没传有效证书,此时需确认用户创建语句中是否含REQUIRE SSL类约束 - 用
mysql --ssl-mode=VERIFY_IDENTITY -h example.com失败,但换IP成功 → 证书CN或SAN里没填example.com,得重签证书
Java/JDBC连接MySQL启用TLS的关键点
JDBC URL里开关TLS不像命令行那么直观,参数名和行为容易误解。
- 必须加
?useSSL=true&requireSSL=true,缺一不可:useSSL控制驱动是否尝试TLS,requireSSL才真正拒绝非加密连接 - 证书信任靠JVM的
javax.net.ssl.trustStore,不是MySQL自己的ssl-ca;想复用MySQL PEM证书,得转成JKS或PKCS#12再导入 -
verifyServerCertificate=true默认为false,不校验证书意味着MITM风险;设为true后还必须配trustCertificateKeyStoreUrl - MySQL 8.0.23+ JDBC驱动开始支持
sslMode=REQUIRED(对标命令行),更清晰,但旧项目仍大量用useSSL/requireSSL组合
服务端 require_secure_transport=ON 是最后一道防线,但只拦住TCP连接,不拦本地socket;真要堵死所有明文通路,还得关掉 skip-networking=OFF 并禁用 unix_socket 插件——这些细节,调完客户端配置后常没人再回头查服务端。










