MyBatis-Plus分表路由方案与业务层改造实践

1. 分表改造的业务背景与核心挑战在业务系统发展到一定规模后单表数据量膨胀带来的性能问题会逐渐显现。以订单系统为例当单表记录超过500万时即使有索引加持查询延迟也会明显上升。这时就需要考虑分表方案——将数据按特定规则分散到多个结构相同的物理表中。分表改造的核心难点在于业务层如何无感知地操作分散的数据。想象一下一个电商系统要查询用户半年内的订单如果订单表已按月拆分成了6张表业务代码该如何优雅地处理直接写死表名显然不可取硬编码分表逻辑更是维护噩梦。这就是为什么我们需要在业务层进行系统化改造。提示分表与分库是两种不同维度的拆分策略。分表解决单机容量问题分库解决分布式扩展问题。本文聚焦单库内的分表场景。2. 动态分表路由方案设计2.1 基于MyBatis-Plus的分表路由MyBatis-Plus从3.4.0版本开始提供动态表名插件这正是我们需要的武器。以下是典型配置示例public class OrderTableNameHandler implements TableNameHandler { Override public String dynamicTableName(String sql, String tableName) { // 从线程上下文获取分表后缀 String suffix TableNameContext.getSuffix(); return StringUtils.isNotBlank(suffix) ? tableName _ suffix : tableName; } } Configuration public class MybatisPlusConfig { Bean public DynamicTableNameInnerInterceptor dynamicTableNameInnerInterceptor() { return new DynamicTableNameInnerInterceptor(new OrderTableNameHandler()); } }关键点在于如何设置TableNameContext。我们通常在Service层通过AOP实现Around(execution(* com..service.*.*(..))) public Object around(ProceedingJoinPoint point) throws Throwable { // 解析方法参数获取分表键值 Long userId parseUserId(point.getArgs()); String suffix getSuffixByUserId(userId); try { TableNameContext.setSuffix(suffix); return point.proceed(); } finally { TableNameContext.clear(); } }2.2 分片键的选择策略选择合适的分片键直接影响查询效率。常见方案包括用户ID哈希userId % 10将数据均匀分散到10张表时间范围按月分表order_202301、order_202302地域编码适合有明显地域特征的数据注意避免使用可能产生热点数据的字段作为分片键如订单状态字段90%订单集中在已完成状态。3. Service层的改造实践3.1 查询场景的改造对于单条查询直接携带分片键即可public Order getById(Long orderId, Long userId) { // userId用于路由到正确的分表 return orderMapper.selectById(orderId); }复杂的是跨分片查询。比如要查用户最近3个月的订单public ListOrder listRecentOrders(Long userId, int months) { ListOrder result new ArrayList(); ListString suffixes calculateTableSuffixes(months); for (String suffix : suffixes) { TableNameContext.setSuffix(suffix); result.addAll(orderMapper.selectByUserId(userId)); } return result; }3.2 事务处理的特殊考量分表后的事务处理需要特别注意。当操作涉及多个分表时本地事务可能无法保证原子性。解决方案包括尽量设计让事务操作落在同一分片引入分布式事务框架增加系统复杂度最终一致性补偿机制4. 与MyBatis-Plus版本相关的坑4.1 版本兼容性问题MyBatis-Plus 3.5.x与Spring Boot的版本对应关系3.5.1 需要Spring Boot 2.6.x3.5.17建议搭配Spring Boot 2.7.8版本不匹配可能导致动态表名插件失效。我曾遇到过3.5.10与Spring Boot 2.5.6组合下拦截器不生效的问题升级到2.7.3后解决。4.2 分页查询的陷阱跨分片分页是个经典难题。假设每页10条数据简单的做法是先各分片取10条再合并public PageOrder pageOrders(Long userId, PageOrder page) { ListOrder records suffixes.stream() .flatMap(suffix - { TableNameContext.setSuffix(suffix); return orderMapper.selectPage( new Page(1, page.getSize()), Wrappers.query(new Order().setUserId(userId)) ).getRecords().stream(); }) .limit(page.getSize()) .collect(Collectors.toList()); page.setRecords(records); return page; }但这种实现有严重问题当数据分布在多个分片时排序和总数计算都不准确。生产环境建议使用Elasticsearch等中间层做聚合查询。5. 监控与维护建议分表系统需要额外的监控项各分表数据量增长监控跨分片查询耗时报警分片键分布均匀性检查维护时要注意新增分表需要提前规划最好在达到70%容量时就扩容历史数据归档要考虑分表结构DDL操作需要批量执行到所有分表我在实际项目中总结出一个经验分表改造后一定要在预发布环境用真实数据量进行全链路压测。曾经有一次上线后才发现某个边缘查询漏掉了分表逻辑导致生产环境全表扫描。