SSL是否启用以have_ssl=YES为硬性前提,若为DISABLED需重装官方包;用户须配REQUIRE SSL且用非localhost地址测试;客户端必须显式启用TLS并匹配服务端tls_version。

确认服务端SSL是否真正启用
很多“SSL连不上”的问题,根源其实是服务端压根没加载SSL模块。执行SHOW VARIABLES LIKE 'have_ssl';,如果返回DISABLED或空值,说明mysqld启动时未链接OpenSSL——常见于MariaDB精简版、或官方包被阉割过。此时哪怕配置了ssl_ca也完全无效。
顺带查一下SHOW VARIABLES LIKE 'tls_version';,确认服务端实际支持的协议(如TLSv1.2,TLSv1.3)。旧客户端连不上时,临时放宽协议不是好办法,而是该先升级客户端。
- 别信配置文件里写了就等于生效,
have_ssl = YES是硬性前提 - 若为
DISABLED,优先重装官方MySQL二进制包(自带OpenSSL),不建议自行编译修复 - 某些云数据库(如阿里云RDS)默认禁用
have_ssl,需在控制台单独开启SSL功能开关
检查用户权限是否绑定REQUIRE SSL
REQUIRE SSL不是全局开关,而是写在每个用户的权限记录里。执行SELECT user, host, ssl_type FROM mysql.user WHERE user = 'xxx';,ssl_type必须是ANY或X509才表示生效。
注意:localhost连接默认走Unix socket,完全绕过网络层和SSL检查;测试务必用127.0.0.1或远程IP,否则永远测不出效果。
- MySQL 8.0.21及更早版本不支持对已有用户追加
REQUIRE SSL,只能重建用户:CREATE USER 'app'@'%' IDENTIFIED BY 'pwd' REQUIRE SSL; - MySQL ≥ 8.0.22可用
ALTER USER 'app'@'%' REQUIRE SSL;,但需确认执行后ssl_type字段已更新 - 如果用户同时有
'user'@'%'和'user'@'localhost'两条记录,后者会优先生效且无视SSL要求
客户端必须显式触发TLS握手
服务端配得再全,客户端不主动发起TLS握手,连接仍走明文。错误日志里看到SSL connection error: protocol version mismatch,基本就是客户端和服务端TLS版本没对齐。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
MySQL 5.7+默认启用TLSv1.2,但旧客户端(如MySQL 5.6 CLI、低版本mysql-connector-python)可能只支持TLSv1.0,导致握手阶段直接失败。
- 命令行连接加参数:
mysql -u xxx -p --ssl-mode=REQUIRED --tls-version=TLSv1.2(MySQL 8.0+ CLI) - Python中指定协议:
mysql.connector.connect(..., tls_versions=['TLSv1.2']),别依赖默认值 - .NET驱动(
MySql.Data.dll≥ 8.0.8)默认开启SSL,需在连接字符串加SslMode=none;临时关闭,或改用SslMode=Required;并配证书路径 - Java连接URL加
&enabledTLSProtocols=TLSv1.2,否则可能fallback到不安全协议
用openssl s_client验证服务端真实证书链
别只信客户端日志里的“SSL enabled”,得从TCP层确认服务端到底发了什么证书、协商了什么协议。这是排查中间人、自签名证书未导入、CA路径错误等问题最直接的方式。
运行:openssl s_client -connect 127.0.0.1:3306 -servername your-domain.com(注意:MySQL不校验SNI,但-servername可绕过某些代理拦截)。
- 看输出里是否有
Verify return code: 0 (ok),非0说明证书链不可信 - 检查
Server certificate部分是否包含完整证书,以及Protocol字段是否为预期版本(如TLSv1.2) - 如果返回
no peer certificate available,说明服务端根本没下发证书——大概率是ssl_cert路径错、权限不对(server-key.pem必须600)、或mysql用户无读取权限
真正卡住的地方往往不在证书生成,而在路径权限、用户host匹配、客户端协议协商这三处。尤其是localhost走socket、127.0.0.1走TCP这种隐式行为,最容易让人反复怀疑配置本身。










