必须先确认have_ssl=YES且ssl_ca为非空绝对路径,否则REQUIRE X509无效;需配合REQUIRE SUBJECT/ISSUER、客户端完整证书链及require_secure_transport=ON,缺一不可。

确认服务端 SSL 和 CA 配置已真正生效
直接给用户加 REQUIRE X509 不会起作用,除非 MySQL 服务端已加载且能验证证书链。第一步必须验证:SHOW VARIABLES LIKE 'have_ssl'; 返回 YES;再查 SHOW VARIABLES LIKE 'ssl_ca';,确保值是绝对路径(如 /var/lib/mysql/ca.pem),不能是 OFF 或空值。
常见卡点:
- CA 文件(
ca.pem)权限不是644,或属主不是mysql用户 -
mysqld启动时没显式指定--ssl-ca,仅靠配置文件里的ssl_ca变量不够——MySQL 8.0+ 要求启动参数或配置项中明确定义,否则 X509 验证逻辑不触发 - SELinux 或 AppArmor 静默拒绝读取证书文件,临时执行
setenforce 0可快速排除
创建用户时必须绑定 SUBJECT 或 ISSUER,不能只写 REQUIRE X509
REQUIRE X509 本身只检查客户端是否提供了证书,不校验身份。生产环境必须配合 REQUIRE SUBJECT 或 REQUIRE ISSUER 才有意义。
实操要点:
- 用
openssl x509 -in client-cert.pem -subject -noout获取完整 subject 字符串,例如/CN=app-client/OU=API/O=MyOrg/C=CN - 创建语句中必须严格匹配,斜杠和等号之间**不能有空格**:
CREATE USER 'api'@'%' REQUIRE SUBJECT '/CN=app-client/OU=API/O=MyOrg/C=CN'; - 若用
REQUIRE ISSUER,则需对齐 CA 的 issuer 字段,适合多租户共用一个 CA 的场景 - 单独
REQUIRE X509等于开放所有合法证书登录,私钥一旦泄露,攻击者可用同 CA 下任意其他证书冒充
客户端连接必须提供三要素证书文件,并启用 TLS 握手
服务端设了 REQUIRE SUBJECT,客户端不带证书,连接会直接被拒,错误常是 Access denied for user ——这不是密码错,而是协议层拒绝,连认证流程都没走到。
命令行测试必须带全参数:
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
mysql -u api -h 192.168.1.100 -p --ssl-mode=REQUIRED --ssl-ca=ca.pem --ssl-cert=client-cert.pem --ssl-key=client-key.pem- JDBC URL 要含
&useSSL=true&requireSSL=true&enabledTLSProtocols=TLSv1.2&clientCertificateKeyStoreUrl=file:client-keystore.jks&trustCertificateKeyStoreUrl=file:truststore.jks - PHP mysqli 需传
MYSQLI_CLIENT_SSL标志,并在连接选项中指定ssl_cert、ssl_key、ssl_ca
漏掉任一文件(尤其是 --ssl-ca),OpenSSL 验证链就断了,MySQL 不会 fallback。
require_secure_transport=ON 是可选但强推荐的兜底策略
该变量开启后,所有非本地 socket 连接都必须走 TLS,否则直接报错 ERROR 3159 (HY000)。它和用户级 REQUIRE X509 是正交关系:前者管“是否加密”,后者管“是否用证书认证”。两者叠加才能达成“强制加密 + 强制证书身份核验”。
启用方式(MySQL 5.7+):
- 配置文件中加:
require_secure_transport=ON - 运行时设置:
SET PERSIST require_secure_transport = ON;
注意:该设置不影响 localhost 的 Unix socket 连接,也不影响已存在的未加密连接(新连接才拦截)。如果已有大量旧客户端未适配 SSL,上线前务必灰度验证。










