简介这份资源是 MyCat 2 的安装模板压缩包版本 1.21面向需要快速搭建分布式数据库中间件的 Java 开发者与运维人员。MyCat 2 作为开源数据库分片工具可实现数据分片、读写分离与 SQL 路由而该模板将部署所需的配置与脚本预先整理降低了初学者的上手门槛。压缩包共 52 个文件约 1.19MB涵盖 sql 初始化脚本、json 配置、xml 与 properties 配置文件以及适配 Linux、Windows、macOS、AIX、Solaris 等多平台的 wrapper 启动库与可执行文件另有 jar 包和日志目录结构基本覆盖安装与运行所需。已有 640 人学习下载。借助这套模板读者可省去逐项搭建目录与脚本的繁琐直接聚焦于 server.json、schema 等核心配置的调整快速完成服务启动与连接测试并为后续分片策略设计与性能调优打下基础。1. mycat2 install-template 到底解决了什么麻烦手里拿到mycat2-install-template-1.21.zip的人大概率正卡在同一个坎上Mycat2 官方仓库拉下来的源码要自己配 Maven、自己拼 lib 目录、自己写启动脚本一套流程走完分库分表的验证还没开始环境已经耗掉半天。install-template 这个包的存在意义就是把这段重复劳动固化下来——它是一份预置好目录结构、依赖 jar、配置模板和启动脚本的安装骨架解压即用改完配置就能起服务。它适合三类人一是要做 MySQL 分库分表 PoC、想快速看到读写分离和分片路由效果的后端二是需要在离线内网环境部署 Mycat2、没法直接连中央仓库拉依赖的运维三是想读 Mycat2 配置体系、拿一份完整可跑的样例当参照的学习者。这篇笔记就按「解压 → 改配置 → 起服务 → 连上去验证 → 排错」的顺序把 install-template 的落地路径讲透参数怎么设、坑在哪都落到具体文件和命令上。2. 拆开 install-template目录结构与依赖关系2.1 解压后你会看到什么拿到 zip 先别急着改配置花两分钟把目录认全后面排错能省很多事。用unzip -l先看清单再解压到目标路径# 先看压缩包内容确认没有多余层级 unzip -l mycat2-install-template-1.21.zip # 解压到指定目录-d 指定目标避免污染当前目录 unzip mycat2-install-template-1.21.zip -d /opt/mycat2 # 进入解压后的根目录确认结构 cd /opt/mycat2 ls -la解压后典型结构是bin/启动脚本、conf/配置模板、lib/依赖 jar、logs/日志输出。bin里通常有mycat启动脚本和wrapper相关文件conf里是server.json、datasource相关配置和 schema 定义lib里是 Mycat2 核心 jar 加连接池、序列化等第三方依赖。逻辑说明unzip -l先列清单是为了确认压缩包内是否多套了一层目录有些打包会把所有文件塞进一个同名文件夹如果多一层解压后路径会变成/opt/mycat2/mycat2-install-template-1.21/...启动脚本里的相对路径就会错位。参数上-d指定解压目标比先cd再解压更可控。2.2 依赖 jar 和 JDK 版本的对应关系Mycat2 基于 Java 开发install-template 里的 jar 是按特定 JDK 版本编译的。1.21 这个模板一般对应 JDK 8 或 JDK 11具体看lib里核心 jar 的编译目标。用javap或直接看启动脚本里的JAVA_HOME引用能确认# 查看核心 jar 的编译版本major version 52JDK8, 55JDK11 javap -v -cp lib/mycat2-core*.jar 2/dev/null | grep major version # 确认当前环境 JDK 版本 java -version # 看启动脚本里怎么找 JAVA_HOME grep -n JAVA_HOME\|java bin/mycat | head -20逻辑说明javap -v输出的major version是判断 jar 编译目标的可靠依据52 对应 JDK 855 对应 JDK 11。如果环境 JDK 版本低于 jar 编译版本启动会直接抛UnsupportedClassVersionError。启动脚本里一般会优先用JAVA_HOME找不到才用 PATH 里的java所以内网机器上要确保JAVA_HOME指向正确版本。参数说明-cp指定 classpath2/dev/null屏蔽找不到类的报错噪音grep major version只取关键行。这一步不做后面起不来会误以为是配置问题实际是 JDK 版本不匹配。提示install-template 里的 jar 是打包时固定的不要随意替换成其他版本的 Mycat2 jar版本错配会导致配置解析行为不一致。3. 从零跑通配置、启动、连接验证3.1 改 server.json 和 datasource 配置Mycat2 的配置核心是conf下的 JSON 文件。启动前至少要改两处服务端口和真实 MySQL 数据源。先看server.json里的监听配置{ server: { port: 8066, managerPort: 9066, charset: utf8mb4 }, user: { root: { password: your_password, schemas: [test_schema] } } }逻辑说明port是客户端连接端口默认 8066managerPort是管理端口默认 9066两个别搞混。user段定义登录 Mycat2 的账号不是 MySQL 的账号schemas指定这个用户能访问的逻辑库。密码建议改掉默认值内网也别留空。接着配真实数据源通常在conf/datasource或conf/cluster相关文件里指向后端 MySQL{ name: mysql_ds_0, type: JDBC, url: jdbc:mysql://192.168.1.10:3306/real_db?useSSLfalseserverTimezoneAsia/Shanghai, user: db_user, password: db_password, minCon: 2, maxCon: 10 }参数说明url里的serverTimezone必须显式指定否则 MySQL 8 驱动会报时区错误useSSLfalse在内网可关公网环境按需开。minCon/maxCon是连接池上下限PoC 阶段 2 到 10 够用压测时再调大。name这个标识后面在 schema 定义里要引用命名保持一致。3.2 启动脚本与日志观察配置改完用bin下的脚本启动。不同模板脚本名可能不同常见是mycat或startup.sh# 赋予执行权限解压后可能丢失 chmod x bin/*.sh bin/mycat 2/dev/null # 前台启动方便直接看输出 bash bin/mycat start # 或者后台启动后跟踪日志 tail -f logs/mycat.log逻辑说明前台启动适合首次验证报错直接打在终端上后台启动适合稳定运行但要立刻tail -f日志否则启动失败你只能看到进程没了却不知道原因。日志里重点看三类信息配置解析是否成功、数据源连接是否建立、监听端口是否绑定。参数说明如果脚本支持start/stop/restart子命令按标准用法走如果只是纯启动脚本停服务用kill对应 PID。启动后确认端口# 确认 8066 和 9066 已监听 ss -tlnp | grep -E 8066|90663.3 用 mysql 客户端连上去验证路由服务起来后用标准 MySQL 客户端连 Mycat2 的 8066 端口验证逻辑库和分片路由# 连接 Mycat2注意端口是 8066 不是 3306 mysql -h127.0.0.1 -P8066 -uroot -p # 连上后看逻辑库 SHOW DATABASES; # 建表并插入观察是否路由到后端 USE test_schema; CREATE TABLE t_order (id BIGINT PRIMARY KEY, user_id INT, amount DECIMAL(10,2)); INSERT INTO t_order VALUES (1, 1001, 99.50); SELECT * FROM t_order;逻辑说明SHOW DATABASES看到的是 Mycat2 暴露的逻辑库不是后端 MySQL 的真实库。建表和插入如果成功说明路由规则、数据源连接、SQL 解析这条链路是通的。如果插入报错先看日志里 SQL 被路由到了哪个数据源再核对那个数据源的真实 MySQL 是否可达。参数说明-P8066大写 P 指定端口小写 p 是密码提示别写反。-h127.0.0.1连本机如果 Mycat2 部署在别的机器就换成对应 IP。验证阶段建议先用简单单表确认链路通了再上分片规则否则分片配置和连接问题混在一起很难定位。4. 避坑与排查install-template 落地时的五个翻车点4.1 启动报 UnsupportedClassVersionError现象执行启动脚本终端或日志里抛java.lang.UnsupportedClassVersionError提示 class file version 不支持。原因环境 JDK 版本低于 install-template 里 jar 的编译版本。比如 jar 是 JDK 11 编译的major version 55环境只装了 JDK 8支持到 52加载核心类时直接失败。解决用javap -v确认 jar 的 major version对照装对应 JDK。JDK 8 对应 52JDK 11 对应 55JDK 17 对应 61。装好后把JAVA_HOME指过去重新source环境变量再启动。别指望用低版本 JDK 硬跑高版本编译的 jar这不是配置能绕过的。4.2 端口被占用导致启动静默失败现象脚本执行完没报错但ss -tlnp看不到 8066 监听客户端连不上。原因8066 或 9066 已被其他进程占用Mycat2 绑定失败但部分启动脚本把异常吞了只在日志里留一行。解决先查占用ss -tlnp | grep -E 8066|9066 # 或 lsof -i:8066找到占用进程后要么停掉它要么改server.json里的port/managerPort换端口。改完端口记得客户端连接命令也要同步改-P参数。4.3 数据源连不上但日志只说 timeout现象Mycat2 起来了但一执行 SQL 就卡住或报连接超时日志里只有timeout没有具体原因。原因后端 MySQL 的url配置有问题常见是serverTimezone没写、IP 端口写错、或者 MySQL 用户没有从 Mycat2 所在机器登录的权限。解决先在 Mycat2 所在机器上用mysql客户端直连后端 MySQL确认网络和账号没问题mysql -h192.168.1.10 -P3306 -udb_user -p real_db -e SELECT 1;直连能通再回来看 Mycat2 的 datasource 配置。重点检查url里的serverTimezone、useSSL以及 MySQL 用户的host授权范围%还是具体 IP。这一步是血泪经验Mycat2 的报错经常把底层异常包一层直连测试能快速区分是网络问题还是配置问题。4.4 配置改了不生效还是旧行为现象改了server.json或 schema 配置重启后行为没变。原因改错了文件或者模板里有多份同名配置实际加载的是另一份。install-template 有时会带.bak或示例配置容易改串。解决启动时看日志里加载的配置文件绝对路径确认到底读的哪个文件grep -i load.*config\|config.*file logs/mycat.log | head确认路径后只改那一份。另外注意 JSON 格式多一个逗号或少一个引号会导致解析失败回退到默认值改完用python -m json.tool校验一下python -m json.tool conf/server.json /dev/null echo JSON OK4.5 客户端连上但 SHOW DATABASES 为空现象能连上 8066但SHOW DATABASES没有预期的逻辑库。原因server.json里用户的schemas配置和实际 schema 定义文件对不上或者 schema 文件没被加载。解决核对server.json里user段的schemas数组确保每个名字在conf下有对应的 schema 定义文件。schema 文件里引用的数据源name要和 datasource 配置里的name完全一致大小写敏感。改完重启再看日志里 schema 加载记录。5. 把 install-template 用成可复用的部署基线跑通一次不算完install-template 真正的价值是当部署基线反复用。我的习惯是解压后先做三件事把conf下所有配置纳入版本管理Git 或内部配置库把bin启动脚本里的JAVA_HOME改成读环境变量而不是硬编码把logs目录挂到独立盘避免日志写满根分区。进阶用法上可以基于这份模板做多环境差异化用conf/dev、conf/prod分目录存配置启动脚本加个-e参数决定加载哪套。这样同一份 install-template 骨架能覆盖开发、测试、生产不用每次重新解压改配置。验证部署是否健康我一般写个小脚本定期连 8066 执行SELECT 1通了说明路由链路正常不通就告警#!/bin/bash # 健康检查连 Mycat2 执行简单查询 if mysql -h127.0.0.1 -P8066 -uroot -p$MYCAT_PWD -e SELECT 1; /dev/null 21; then echo mycat2 healthy else echo mycat2 down exit 1 fi参数说明密码从环境变量读别写死在脚本里。这个检查可以挂到 cron 或监控系统比等业务报错再排查主动得多。一个具体技巧install-template 里的lib依赖 jar 不要随意增删但可以往里加自己需要的 JDBC 驱动版本。加之前先确认和现有驱动不冲突加完用java -cp lib/*跑个最小加载测试确认类路径没炸。我踩过的坑是往lib里塞了个高版本 MySQL 驱动和模板自带的驱动冲突启动时类加载顺序不确定时好时坏排查了很久才发现是双驱动打架。后来养成习惯动lib之前先备份动完必做一次完整启动加查询验证。这套流程走下来mycat2-install-template-1.21.zip就不再是一个解压完不知道从哪下手的压缩包而是一份能反复复用的分库分表部署起点。希望帮到你。本文还有配套的精品资源点击获取
