简介mycat2-install-template-1.21.zip 是 MyCat 2 的安装模板包面向需要在 Linux、Windows 等平台快速搭建数据库中间件服务的开发与运维人员省去手工整理目录、编写基础配置的繁琐过程。压缩包共 52 个文件约 1.19MB内含跨平台 wrapper 守护程序及动态链接库、JAR 运行库、启动脚本以及 SQL 初始化脚本、JSON 配置模板和日志框架配置这些文件覆盖服务启停、数据源定义、分片规则、全局序列等常用部署环节。解压后可按模板核对 MyCat 2 的目录结构理解各配置项之间的引用关系通过调整 JSON 与 SQL 配置即可从零生成可运行的 MyCat 2 实例。借助该模板读者能快速获得一套分库分表中间件的基线环境为后续接入业务或深入学习数据分片、读写分离、分布式事务等能力提供清晰起点。目前已有 640 人学习适合正在入门 MyCat 2、需要干净安装基线或对照官方文档验证环境的开发者使用。1. mycat2 install-template你离一套能跑的分库分表中间件只差解压mycat2 install-templatemycat2-install-template-1.21.zip是官方发布的一个部署骨架包它把 Mycat2 这个分布式数据库中间件从“一堆依赖 JAR”变成“解压、改配置、启动”三个动作。很多团队第一次接触分库分表都被集群方案和规则引擎劝退但如果你只想快速验证 Mycat2 的路由、读写分离或者分片效果这个模板就是性价比最高的入口。它适合两类人一类是刚接手 Mycat2、想在一个干净环境里跑通流程的运维和 DBA另一类是做选型调研的开发先拿模板起一个实例压测一轮再决定要不要往生产方向投入。这篇文章会把这个模板的启动链路、配置改动点和典型坑一次讲透。2. 先看 install-template 里有什么目录结构和启动链路拿到 mycat2-install-template-1.21.zip第一件事不是急着解压而是先弄清这个模板和 Mycat2 源码包的关系。源码包是给开发者编译调试用的install-template 是给使用者直接落地的。模板里预置了运行所需的 lib 依赖、启动脚本和一套开箱即用的配置骨架。2.1 解压后的标准目录长什么样一个标准模板解压后核心目录和文件大致如下mycat2-install-template-1.21/ ├── bin/ │ ├── mycat │ └── mycat.bat ├── conf/ │ ├── mycat.yml │ ├── users.yml │ ├── datasources.yml │ ├── cluster.yml │ └── schemas.yml ├── lib/ │ ├── mycat2-1.21-xxxx.jar │ └── ...若干依赖 jar └── logs/这套结构里bin 下的mycat是 Linux 启动脚本Windows 环境用同目录的.bat文件。conf 目录是配置核心mycat.yml控制实例自身的运行模式和数据目录位置users.yml定义客户端连接 Mycat 时的账号权限datasources.yml管理后端真实 MySQL 地址和连接池cluster.yml配置集群节点信息schemas.yml则是逻辑库、逻辑表的分片规则映射。2.2 从启动脚本到配置生效的顺序启动时模板的bin/mycat脚本会先定位到安装根目录加载 conf 下的配置文件再用java -cp lib/*拉起主类。这里的关键是启动顺序Mycat2 会先解析mycat.yml确认当前是单机模式还是集群模式再初始化数据源和用户权限最后才加载分片规则。# 解压后先给执行权限 chmod x bin/mycat # 前台启动日志直接打到当前终端 ./bin/mycat console启动方式可以选console前台模式或start后台守护模式。第一次跑建议用console这样配置加载报错能当场看到堆栈。启动成功后模板默认监听8066端口等待客户端连接1984端口用于管理命令。2.3 模板里的 lib 目录为什么动不得有个常被忽略的细节lib目录里的依赖 JAR 版本和conf里的配置格式是一一对应的。如果你后期从 Maven 仓库拉了一个新版本的 Mycat2 核心包替换进去旧配置可能直接报IllegalArgumentException或者字段不识别。所以在这个模板上做升级的正确姿势是整体换包而不是单文件替换。这个约束在你引入团队自己的封装 JAR 时同样适用。3. 把模板改成能连你本地 MySQL四个配置文件逐个调模板自带的配置指向的是一个示例库地址如果你直接启动就连接大概率会在初始化数据源时失败。这个章节我们从零把这套配置改成能连上你自己 MySQL 的状态并说清楚每个参数为什么这么调。3.1 修改 datasources.yml连接池和账号密码datasources.yml是模板里最常被改的文件。它定义了一个逻辑数据源名称到实际 MySQL 地址的映射包括连接池的初始大小、最大连接数、空闲超时等参数。dataSources: ds0: url: jdbc:mysql://127.0.0.1:3306/db_shop?useUnicodetruecharacterEncodingutf8 username: mycat_user password: 123456 connectionInitSqls: - set names utf8mb4 connectionTimeout: 3000 maxRetries: 3这里ds0是这个数据源的逻辑名后面schemas.yml里写分片规则时要用它来指代后端库。connectionInitSqls是连接池在新建连接时执行的初始化 SQL我一般会让它和业务库的字符集保持一致避免查询结果出现乱码。connectionTimeout建议设成 3000 毫秒太短容易在数据库瞬时重启时误判不可用太长会让等待的线程堆起来。3.2 修改 users.yml连接 Mycat 的账号凭据模板里的users.yml控制的是客户端连接 Mycat 时的账号信息它和上面数据源的账号是两层概念。客户端先认证通过 users.yml 里的账号Mycat 再用 datasources.yml 里的账号去连接后端库。users: - name: root password: 123456 schemas: - db_shop defaultSchema: db_shop如果你嫌前端账号和后端账号混合容易搞混这里给个经验前端用户的权限按业务需要最小化后端数据源账号建议单独建一个只具备 SELECT、INSERT、UPDATE、DELETE 权限的 MySQL 账号不要把 DBA 的高权限账号直接写进 datasources.yml。3.3 修改 schemas.yml逻辑库到数据源的映射schemas.yml是模板里最能体现 Mycat2 价值的地方。这里定义逻辑库db_shop下的表哪些走单库单表、哪些按字段取模分片。schemas: db_shop: targetName: ds0 tables: order_info: columns: - id - user_id sharding: column: user_id strategy: mod targetNodes: - { targetName: ds0, start: 0, end: 0 }这段话的意思是order_info表当前只落在ds0这一个数据源上但已经声明了按user_id取模的规则。早期验证阶段你可以不建分片只做透传就保持targetName: ds0单节点配置。真正要分片时再在targetNodes里增加ds1、ds2等数据源节点并调整取模范围。3.4 修改 mycat.yml运行模式和元数据存储mycat.yml控制的是 Mycat 本身的运行形态。模板默认是单机模式mode: local元数据配置存在本地适合验证功能。如果团队准备上多实例需要切换成mode: cluster并配置集群节点列表。mode: local dataPath: ./datadataPath是存放元数据和临时文件的位置。我建议绝对不要把它放在系统盘因为 Mycat 在跑批量导入或大结果集排序时会在该目录下生成临时文件系统盘满了会拖垮整个实例。把这个目录移到独立数据盘是模板落地到生产的第一步。4. 从模板到一个可对外服务的实例启动、验证与常见问题排查配置改完接下来是启动验证环节。很多人在这一步卡住不是配置写错而是没有按顺序排查。这个章节会按“启动报错、连接失败、查询异常”三个层面把典型问题筛一遍。4.1 启动后端口没监听先看日志再改配置启动失败的常见现象是ps -ef | grep mycat能看到 Java 进程但netstat -tlnp | grep 8066没输出。这个现象常让人误判成配置完全没加载实际上进程活着但监听端口失败十有八九是端口被占用或配置里的监听地址写错。# 查看 mycat 日志文件 tail -200 logs/wrapper.log解决方法是先看日志里有没有BindException或者Address already in use如果有就是端口冲突直接改mycat.yml里的listenPort。改完重启前一定要确认旧进程已经 kill 干净因为模板脚本不会主动清理残留进程两个实例抢同一个端口会互相踢表现成“启动成功但一会儿就挂”。4.2 MySQL 8 连不上认证插件不兼容mycat2 install-template 对应的是 JDBC 驱动对 MySQL 认证方式的兼容性问题。MySQL 8 默认的caching_sha2_password认证插件在 Mycat2 内置的驱动版本上会报Public Key Retrieval is not allowed或Unable to load authentication plugin。解决方式有两种一是修改 MySQL 端用户认证插件为mysql_native_password在 MySQL 里执行ALTER USER mycat_user% IDENTIFIED WITH mysql_native_password BY 123456;二是在 datasources.yml 的 url 里显式加上allowPublicKeyRetrievaltrueuseSSLfalse。我一般推荐第一种因为改数据源 URL 只对单个数据源生效而后端一批库都要改的话统一在 MySQL 层面解决更干净。4.3 查询报“找不到表”或“路由不到”schema 名没对上连接 Mycat 后执行select * from order_info报Table db_shop.order_info doesnt exist但这张表在后端 MySQL 里确实存在。这个坑的原因是用户在schemas.yml里定义逻辑库时没有把逻辑库名和物理库名对齐。Mycat2 默认把逻辑库名当作物理库表的前缀去查找如果逻辑库叫db_shop而后端库叫db_shop_01就会找不到。解决方法是把物理库的映射显式写出来在datasources.yml的数据源 URL 里用rewriteBatchedStatementstrue以及connectTimeout之外最常见的写法是把 URL 改成jdbc:mysql://127.0.0.1:3306/db_shop_01让数据源直接指向物理库。这样schemas.yml里的db_shop就只是客户端看到的逻辑名称实际读写落在db_shop_01上。4.4 分片字段查询生效但范围查询结果错乱如果你已经按模板样例把order_info拆到两个数据源按user_id等值查没问题按create_time范围查却漏数据这个坑十有八九是全局表或广播表没配置。Mycat2 对分片表的范围查询会并行下发到所有分片再合并但如果某张表本是字典表比如region_info在分片设计里应该每个分片都存一份却被做成了单节点存储那关联查询时就会丢数据。模板里有单独的globalTables配置项把这类字典表列进去Mycat 会自动把写入广播到全部分片。schemas: db_shop: targetName: ds0 globalTables: - region_info4.5 连接池耗尽默认参数扛不住高并发模板里的默认连接池大小是按轻量验证配置的初始连接数很小最大连接数也很保守。一旦你用压测工具直接打几百并发日志里会出现Get connection timeout异常这是连接池耗尽而不是 Mycat 崩了。解决方式是调整datasources.yml里的maxCon和maxRetries。我一般会按“后端单库最大连接数 / 分片数”来估算。假如单个 MySQL 实例允许 1000 连接Mycat 后面挂了 2 个分片库那么每个数据源的maxCon建议不超过 400留出冗余给 MySQL 自身的管理连接和运维查询。dataSources: ds0: url: jdbc:mysql://127.0.0.1:3306/db_shop_01 user: mycat_user password: 123456 maxCon: 400 minCon: 10 connectionTimeout: 3000 maxRetries: 3这里minCon是常驻连接数设太小会导致冷启动时突发流量把连接池打满设太大又会在低峰期白白占用数据库资源。实践里 10 到 20 是一个安全的起步值。5. 让模板变成你的配置基线启动校验与灰度升级的硬习惯模板本身是静态的真正有价值的是你能不能在每次改完配置后快速确认“这套配置是健康的”。我现在的习惯是任何一次配置变动都要做三步验证。第一步启动后先看logs/wrapper.log里有没有ERROR或WARN特别是数据源初始化成功失败的记录。第二步用客户端连上去执行一条简单查询确认端口、账号、逻辑库三层都通了。第三步故意停掉其中一个后端 MySQL再查一次分片表确认故障转移生效、报错信息准确。这步是很多人跳过但最值得做的它不测成功路径专测失败路径。配置管理上我建议把整个 conf 目录纳入版本管理并且每次发布打一个标签。不要图方便直接在服务器上改配置因为一旦改出了不可逆的参数组合没有后悔药可吃。升级模板版本的时候用旧版 conf 目录做对照逐个比较参数差异尤其注意新版本增加了哪些默认项——这些新增项往往会改变旧实例的运行行为。我踩过的一个典型教训是省掉上述第二步改完配置直接重启结果 Mycat 起来了但账号密码大小写写错前端应用全部连接失败回滚回旧配置才发现只是多了一个空格。这种低级问题只要在验证阶段多花三十秒就不会翻车。模板只是个起点真正让你放心的是围绕它建立起来的那套“改前备份、启动校验、回滚有路”的流程。希望帮到你。本文还有配套的精品资源点击获取