MyCAT分库分表中间件MySQL节点透明升级指南

MyCAT 本身并不具备对 MySQL 节点进行“透明升级”的能力——所谓透明升级，通常指应用连接 MyCAT 的地址保持不变，而底层 MySQL 实例的升级过程必须由人工介入、分步验证，否则极易引发连接中断、路由错乱、事务回滚失败等严重故障。简而言之，如果你期望 MyCAT 能自动感知后端 MySQL 的版本变化并实现平滑切换，大概率会遭遇问题。

MySQL 节点升级前，必须先停掉 MyCAT 对该节点的流量

MyCAT 不会自动感知后端 MySQL 的版本变更或健康状态突变。升级前必须手动干预，并严格按照以下步骤操作：

• 在 schema.xml 中临时注释或移除待升级节点的 readHost 或 writeHost 声明——注意，仅修改 IP 或端口无效，必须彻底摘除节点配置。
• 执行 mycat reload 不会生效：MyCAT 的热加载仅支持部分 rule.xml 变更，修改 schema.xml 后必须执行 mycat restart 才能生效。
• 如果使用了 switchType="-1"（关闭自动切换），MyCAT 不会尝试重连失败节点，但也不会主动剔除它；需要人工确认连接池已清空，否则旧连接仍会残留在池中。
• 升级完成后，使用 mysql -h127.0.0.1 -P8066 -uroot -p 连接 MyCAT，再执行 show @@datasource 查看节点状态是否为 idle 或 ok，而非 init 或 error。

主库升级要特别处理事务与 binlog 兼容性

从 MySQL 5.7 升级到 8.0 是常见场景，但 MyCAT 默认不校验协议和语法兼容性，许多潜在问题隐藏在细节中：

• 8.0 默认启用 caching_sha2_password 认证插件，而 MyCAT 1.6.x 及更早版本仅支持 mysql_native_password。升级后必须执行：ALTER USER 'mycat'@'%' IDENTIFIED WITH mysql_native_password BY 'xxx';
• MyCAT 解析 SQL 依赖 druidparser，如果升级后出现 ERROR 1000 (HY000): Unknown system variable 'transaction_isolation'，说明 MySQL 8.0 的系统变量名已变更，需在 server.xml 中显式配置：300 并重启。
• 主库升级期间，所有写请求必须阻断。MyCAT 不会自动暂停 writeHost 上的写入，运维人员必须提前切换流量或封禁应用写权限，否则升级过程中写请求会直接报错或丢失。

从库升级可滚动，但要注意复制延迟与 readHost 权重

从库滚动升级相对安全，但 MyCAT 不感知复制位点或延迟，需要手动控制节奏：

• 每次只升级一个 readHost，升级前先在 schema.xml 中将其 weight 设为 0（例如：），再重启 MyCAT 生效。
• 升级后检查 show sla ve status\G 中 Seconds_Behind_Master 是否归零；MyCAT 不会等待该值，只关心连接是否通畅——延迟未消除就对外提供读服务，会导致数据不一致。
• 如果从库启用了 GTID，而主库未开启，MyCAT 路由层无法识别 GTID 模式差异，可能导致 SELECT 被错误发送到新从库并报错 ERROR 1236 (HY000): Could not open log file。
• 多个 readHost 权重总和不为 100 也没有影响，MyCAT 按数值比例分配请求；但权重设为负数或非数字会导致启动失败，需避免手误。

升级后最易被忽略的三件事

MyCAT 启动时一次性加载 schema.xml，升级完 MySQL 实例后，很多人以为“能连上就万事大吉”，实际上并非如此：

• show @@heartbeat 显示心跳成功 ≠ 复制正常。必须单独直连每个从库执行 SELECT @@hostname, @@server_id 并比对 show sla ve status，确认复制链路完整。
• MyCAT 日志中 WrapperSimpleApp 报 ja va.net.ConnectException: Connection refused 往往是 MySQL 服务未启动，而非端口冲突——不要急于修改配置，先执行 systemctl status mysqld 查看服务状态。
• 升级后首次连接可能卡在 handshake 阶段：JDK 版本（如 JDK 17）与 MySQL 8.0+ 的 TLS 握手不兼容，需在 mycat/conf/wrapper.conf 中添加：wrapper.ja va.additional.10=-Djdk.tls.client.protocols=TLSv1.2。