如何确定Mycat与MySQL版本的兼容性

SE_Yang

Mycat

2025-12-4

确定 Mycat 与 MySQL 版本的兼容性，核心是参考官方兼容性文档 + 验证核心功能 + 规避已知版本坑，以下是分步骤的实操方法，覆盖「事前查询、事中验证、事后避坑」全流程：

一、第一步：查官方兼容性文档（最权威）

Mycat 官方会明确标注各版本对 MySQL 的适配范围，这是最核心的依据，无需自行试错。

1. 官方文档获取渠道

Mycat 官网：http://www.mycat.org.cn/ → 「文档中心」→ 「版本说明 / 兼容性」；
GitHub 仓库：https://github.com/MyCATApache/Mycat2（2.0.x 版本）/ https://github.com/MyCATApache/Mycat-Server（1.6.x 版本）→ 「README.md」或「RELEASE.md」；
Mycat 权威指南：官网下载的《Mycat 权威指南》中「环境要求」章节。

2. 核心兼容性结论（整理自官方，避免踩坑）

Mycat 版本兼容的 MySQL 版本关键注意事项

Mycat 1.6.x（主流稳定版）

MySQL 5.5/5.6/5.7（完美兼容）；MySQL 8.0（部分兼容）

Mycat 版本	兼容的 MySQL 版本	关键注意事项
Mycat 1.6.x（主流稳定版）	MySQL 5.5/5.6/5.7（完美兼容）；MySQL 8.0（部分兼容）	1. 连接 MySQL 8.0 需修改驱动（替换 `mysql-connector-java` 为 8.0+ 版本）； 2. 需关闭 MySQL 8.0 的 `caching_sha2_password` 认证（改为 `mysql_native_password`）； 3. 不支持 MySQL 8.0 新增的 SQL 语法（如窗口函数）。
Mycat 2.0.x（新版）	MySQL 5.7/8.0（原生兼容）；MySQL 5.6（兼容）	1. 原生支持 MySQL 8.0 的 `caching_sha2_password` 认证，无需修改驱动； 2. 支持 MySQL 8.0 大部分新语法； 3. 对 MySQL 5.5 及以下兼容性差，不建议使用。
Mycat 1.5.x 及以下	MySQL 5.1/5.5/5.6（兼容）	完全不支持 MySQL 8.0，仅适合老旧 MySQL 集群。

1. 连接 MySQL 8.0 需修改驱动（替换 mysql-connector-java 为 8.0+ 版本）；

2. 需关闭 MySQL 8.0 的 caching_sha2_password 认证（改为 mysql_native_password）；

3. 不支持 MySQL 8.0 新增的 SQL 语法（如窗口函数）。

Mycat 2.0.x（新版）

MySQL 5.7/8.0（原生兼容）；MySQL 5.6（兼容）

1. 原生支持 MySQL 8.0 的 caching_sha2_password 认证，无需修改驱动；

2. 支持 MySQL 8.0 大部分新语法；

3. 对 MySQL 5.5 及以下兼容性差，不建议使用。

Mycat 1.5.x 及以下 MySQL 5.1/5.5/5.6（兼容）完全不支持 MySQL 8.0，仅适合老旧 MySQL 集群。

二、第二步：环境验证（实操确认，避免理论偏差）

即使官方标注兼容，也需在实际环境中验证核心功能，确保适配业务场景。

1. 基础验证：连接与简单 SQL 执行

bash
运行

# 1. 用 Mycat 连接 MySQL（通过 Mycat 8066 端口执行 SQL）
mysql -h127.0.0.1 -umycat_app -p123456 -P8066

# 2. 执行基础 SQL，验证连接与语法兼容
use mycat_db;
# 创建表（验证 DDL 兼容）
CREATE TABLE test (id INT PRIMARY KEY, name VARCHAR(50));
# 插入数据（验证 DML 兼容）
INSERT INTO test (id, name) VALUES (1, 'test');
# 查询数据（验证 DQL 兼容）
SELECT * FROM test;
# 删除表（验证 DDL 兼容）
DROP TABLE test;

若执行无报错，说明基础兼容性达标；
若报错（如 Client does not support authentication protocol requested by server），则是认证方式不兼容，需调整 MySQL 或 Mycat 配置。

2. 核心功能验证（针对业务场景）

根据实际使用的 Mycat 功能，验证关键场景：

核心功能	验证方法
读写分离	主库插入数据，从库查询是否同步，Mycat 读请求是否转发到从库（查看 MySQL 通用日志）。
分库分表	按分片规则插入数据，验证数据是否正确分布到各 MySQL 节点，查询是否聚合结果。
事务支持	执行 `BEGIN; INSERT; COMMIT;` 或 `ROLLBACK;`，验证事务是否生效，无数据不一致。
特殊 SQL 语法	执行业务中常用的 SQL（如联表查询、索引查询、MySQL 8.0 窗口函数），验证是否支持。

3. 驱动适配验证（Mycat 1.6.x + MySQL 8.0 重点）

Mycat 1.6.x 默认内置的 mysql-connector-java 是 5.x 版本，无法适配 MySQL 8.0，需手动替换驱动：

bash
运行

# 1. 进入 Mycat 的 lib 目录
cd /usr/local/mycat/lib

# 2. 删除旧驱动
rm -f mysql-connector-java-5.1.47.jar

# 3. 下载 MySQL 8.0 驱动（适配 MySQL 8.0）
wget https://repo1.maven.org/maven2/mysql/mysql-connector-java/8.0.33/mysql-connector-java-8.0.33.jar

# 4. 重启 Mycat 后，重新验证连接
/usr/local/mycat/bin/mycat restart

三、第三步：规避已知版本兼容坑（避坑清单）

结合社区实践，整理高频兼容问题及解决方案，避免重复踩坑：

兼容问题	触发场景	解决方案
MySQL 8.0 认证失败（`caching_sha2_password`）	Mycat 1.6.x 连接 MySQL 8.0	1. 替换 Mycat 驱动为 8.0+ 版本； 2. MySQL 8.0 中修改用户认证方式：`ALTER USER 'mycat'@'%' IDENTIFIED WITH mysql_native_password BY '123456';`
Mycat 不支持 MySQL 8.0 窗口函数	Mycat 1.6.x 执行 `ROW_NUMBER()` 等	1. 升级 Mycat 到 2.0.x； 2. 业务中避免使用该语法，或直接连接 MySQL 执行。
分库分表后主键自增冲突	Mycat 1.6.x + MySQL 8.0	1. Mycat 配置 `autoIncrement="true"`； 2. MySQL 8.0 中设置自增步长，与 Mycat 分片规则匹配。
Mycat 启动失败（`ClassNotFoundException`）	Mycat 2.0.x + JDK 7	升级 JDK 到 8/11（Mycat 2.0.x 不兼容 JDK 7）。

四、第四步：版本选型建议（从兼容性角度）

根据业务场景选择适配的版本组合，避免「高版本 MySQL + 低版本 Mycat」的坑：

业务场景	推荐版本组合	不推荐组合
老旧系统（MySQL 5.6/5.7）	Mycat 1.6.x（稳定）	Mycat 2.0.x（无必要，增加复杂度）
新系统（MySQL 8.0）	Mycat 2.0.x（原生兼容）	Mycat 1.6.x（需手动改驱动，兼容性差）
高并发读写分离	Mycat 1.6.x + MySQL 5.7（稳定）/ Mycat 2.0.x + MySQL 8.0	Mycat 1.5.x + 任意 MySQL 8.0 版本
分库分表 + 新语法需求	Mycat 2.0.x + MySQL 8.0	Mycat 1.6.x + MySQL 8.0（语法支持不足）