ProxySQL需≥2.0.19以原生支持caching_sha2_password认证,否则须降级为mysql_native_password并禁用SSL;MySQL Router 8.0.33+要求后端支持该插件,旧版需显式配置authentication_method=classic。

升级 MySQL Proxy 类中间件(如 MySQL Router、ProxySQL、MaxScale)前,不能只看它自己的版本号——它和后端 MySQL 实例、客户端驱动、甚至应用层协议行为强耦合。很多“升级后连不上”“路由失效”“权限报错”的问题,根源都在版本特性错配。
检查 MySQL Router 与后端 MySQL 的协议兼容性
MySQL Router 从 8.0.19 开始默认启用 X 协议(X DevAPI),但如果你后端是 5.7 或早期 8.0(如 8.0.11),X 协议可能未启用或功能受限。连接时会静默降级,也可能直接拒绝。
- 确认后端 MySQL 是否开启
mysqlx插件:SELECT PLUGIN_NAME, PLUGIN_STATUS FROM INFORMATION_SCHEMA.PLUGINS WHERE PLUGIN_NAME = 'mysqlx'; - 检查
MySQL Router配置中是否误启用了x_protocol=true,而目标实例不支持 - Router 8.0.33+ 默认要求后端支持
caching_sha2_password认证插件;若后端仍是mysql_native_password,需在 Router 配置中显式设authentication_method=classic
ProxySQL 对 MySQL 8.0 默认认证插件的适配问题
ProxySQL 2.0.18 之前版本无法正确处理 caching_sha2_password 插件的握手流程,会导致客户端连接卡在 HandshakeInitializationPacket 阶段,日志里只显示 Client handshake failed,无更具体错误。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
- 升级前务必核对
ProxySQL版本是否 ≥ 2.0.18(推荐 ≥ 2.4.4) - 若必须用旧版 ProxySQL,后端 MySQL 需临时切回
mysql_native_password:ALTER USER 'user'@'%' IDENTIFIED WITH mysql_native_password BY 'pwd'; -
mysql_servers表中max_connections和max_replication_lag在 8.0.26+ 后行为有变化,旧版 ProxySQL 可能误判主从延迟
MaxScale 与 MySQL 8.0 数据字典变更的兼容风险
MaxScale 2.5.x 系列在解析 MySQL 8.0.16+ 的 information_schema 视图时,会因新增的隐藏字段(如 TABLE_COMMENT 扩展、COLLATION_NAME 默认值变化)触发元数据缓存异常,表现为路由规则不生效或监控指标丢失。
- 优先使用 MaxScale 22.08+(对应 MySQL 8.0.30 兼容性白名单)
- 避免在
filter规则中直接引用information_schema.TABLES做条件判断;改用mysql.db或performance_schema中更稳定的表 - 若启用
avrorouter,注意 8.0 默认 binlog_format=ROW + binlog_row_image=FULL,Avro schema 生成逻辑与 5.7 不同,需同步更新下游消费端
最容易被忽略的一点:中间件升级后,mysql_upgrade 不会动它,但它的配置文件里硬编码的 SQL 模式(如 sql_mode=STRICT_TRANS_TABLES)、字符集(如 default_charset=utf8)可能和 MySQL 8.0 的默认值冲突,导致建表失败或隐式转换异常——这些不会报错,只会让某条业务 SQL 在特定条件下静默出错。

















