4 个实用的 Mycat + MySQL 版本兼容性验证清单

SE_Yang

2025-12-8

清单 1：Mycat 1.6.x + MySQL 8.0 适配专项验证清单（解决高版本适配痛点）

专门针对 Mycat 1.6.x 连接 MySQL 8.0 的「驱动 / 认证 / 语法」核心适配问题，快速排查与验证。

验证项	操作步骤	预期结果	异常处理方案
驱动版本适配	`ls -l /usr/local/mycat/lib	grep mysql-connector-java`	驱动版本 ≥8.0（如 8.0.33）	替换旧驱动：删除 5.x 版本，下载 8.0+ 驱动并重启 Mycat
认证方式修正	MySQL 执行：`SELECT user,plugin FROM mysql.user WHERE user='mycat';`	插件为 `mysql_native_password`	执行 `ALTER USER 'mycat'@'%' IDENTIFIED WITH mysql_native_password BY '123456'; FLUSH PRIVILEGES;`
8.0 新特性规避	Mycat 执行：`SELECT id, ROW_NUMBER() OVER (ORDER BY id) AS rn FROM test_compat;`	1.6.x 报错（正常），业务需时升级 Mycat 2.0.x	1. 业务避免用窗口函数；2. 直接连接 MySQL 执行新语法
数据包大小适配	Mycat 执行：`INSERT INTO test_large (content) VALUES (REPEAT('a', 100000));`	无 `PacketTooBigException`	修改 Mycat `server.xml` 中 `maxPacketSize=64M`，MySQL 配置 `max_allowed_packet=64M`
驱动类名配置	检查 Mycat `schema.xml` 中 `dataHost` 的 `driverClassName`	1.6.x 需设为 `com.mysql.cj.jdbc.Driver`	替换旧驱动类名（旧版为 `com.mysql.jdbc.Driver`）

验证集群架构下的读写分离、故障切换、数据一致性，适配生产高可用场景。

验证项	操作步骤	预期结果	异常处理方案
主从同步状态	MySQL 从库执行：`show slave status\G`	`Slave_IO_Running=Yes` 且 `Slave_SQL_Running=Yes`	1. 检查主库 binlog 开启；2. 核对从库 `master_log_file`/`master_log_pos`
Mycat 读负载均衡	1. 开启从库通用日志；2. Mycat 执行 10 次 `SELECT 1;`；3. 查从库日志	读请求均匀分发到所有从库	调整 `schema.xml` 中 `balance=1`（读负载均衡）、`writeType=0`（写走主库）
主库故障切换	1. 停止主库 MySQL；2. Mycat 执行写操作；3. 查看 Mycat 日志	自动切换到备用主库，无写失败	配置 `dataHost` 的 `switchType=1`（自动切换），确保备用主库可写
双主数据一致性	双主库分别插入数据，Mycat 执行 `SELECT * FROM test`	双主数据同步，Mycat 聚合结果无冲突	1. 双主互为主从；2. 自增步长设为 2，起始值分别为 1/2
从库延迟检测	Mycat 管理端口执行：`show @@datasource;`	从库延迟（`delay`）≤1s	1. 优化主从同步参数；2. Mycat 配置 `slaveThreshold=1000`（延迟阈值）

验证分布式事务的提交 / 回滚、数据一致性，适配金融 / 支付等高一致性场景。

验证项	操作步骤	预期结果	异常处理方案
XA 事务提交	Mycat 执行：`SET autocommit=0; XA START 'xa1'; INSERT INTO test_tx VALUES (1, 'xa'); XA END 'xa1'; XA PREPARE 'xa1'; XA COMMIT 'xa1';`	事务提交成功，所有分片数据持久化	1. Mycat 1.6.5+ 支持 XA；2. MySQL 存储引擎为 InnoDB
XA 事务回滚	Mycat 执行：`XA START 'xa2'; INSERT INTO test_tx VALUES (2, 'xa_rollback'); XA END 'xa2'; XA PREPARE 'xa2'; XA ROLLBACK 'xa2';`	所有分片无数据插入，回滚成功	检查 Mycat `server.xml` 中 `defaultTxIsolation=3`（可序列化）
非 XA 事务一致性	Mycat 执行：`BEGIN; INSERT INTO dn1.test VALUES (1, 'tx'); INSERT INTO dn2.test VALUES (2, 'tx'); COMMIT;`	两数据节点均插入成功	1. 关闭 MySQL 自动提交；2. Mycat 配置 `txIsolation=2`（读已提交）
事务超时验证	Mycat 执行长事务，触发超时（如 `wait_timeout=30`）	事务自动回滚，无数据残留	调整 Mycat `server.xml` 中 `txTimeout=60`，MySQL 配置 `wait_timeout=60`

解决 Windows 下的路径、权限、服务启动等特殊兼容性问题。

验证项	操作步骤	预期结果	异常处理方案
路径无空格 / 中文	检查 Mycat 安装路径（如 `D:\mycat`）	路径无空格、中文、特殊字符	迁移到纯英文路径（如 `D:\mycat-1.6.7.6`）
端口占用排查	执行：`netstat -ano	findstr "8066 9066 3306"`	8066/9066（Mycat）、3306（MySQL）无占用	关闭占用端口的进程，或修改 Mycat/MySQL 端口
服务启动权限	以管理员身份运行 `mycat.bat start`	Mycat 服务正常启动，日志无权限报错	1. 授予 Mycat 目录读写权限；2. 关闭 Windows 防火墙
驱动路径适配	检查 `D:\mycat\lib` 中驱动版本	驱动版本与 MySQL 匹配（8.0+ 对应 MySQL 8.0）	替换驱动后，重启 Mycat 服务
命令行编码适配	连接 Mycat 执行：`INSERT INTO test (name) VALUES ('中文测试'); SELECT * FROM test;`	中文正常显示，无乱码	1. Mycat `server.xml` 设 `charset=utf8mb4`；2. MySQL 库表字符集为 `utf8mb4`

阅读剩余

作者：SE_Yang

链接：https://www.cnesa.cn/9805.html

文章版权归作者所有，未经允许请勿转载。

THE END