MyBatis-Plus雪花算法实战：原理、配置与分布式ID生成解决方案

关注

VIP免费原创 2026-08-10 12:40:07 377 阅读 AI 写同款· GEO 优化 ›

MyBatis-Plus自定义ID生成器：打造专属主键策略在数据库设计中，主键的选择和生成策略至关重要。MyBatis-Plus提供了多种ID生成策略，同时支持自定义ID生成器，满足不同业务需求。组成部分位数说明符号位1位固定为0时间戳41位精确到毫秒，可用69年工作机器ID10位5位数据中心ID + 5位机器ID序列号12位同一毫秒内的自增序号，最多4096个✅优点全局唯一性保证趋势递增（对索引友好）包含时间信息高性能（每秒可生成百万级ID）@Bean@Data⚠️注意。阅读详情

1. 项目概述：为什么我们需要关注MyBatis-Plus的雪花算法？

在分布式系统里，给每一条数据生成一个全局唯一的ID，听起来简单，做起来却是个技术活。用过数据库自增主键的开发者都清楚，这玩意儿在单机单库时挺好用，一旦涉及到分库分表、数据迁移或者高并发插入，自增ID的局限性就暴露无遗——它无法保证全局唯一，还会成为性能瓶颈。我见过不少项目初期图省事用了自增ID，等到业务量上来需要扩容时，不得不面对令人头疼的数据合并与ID冲突问题，重构成本极高。

于是，分布式ID生成方案成了必须跨过去的一道坎。在众多方案中，Twitter开源的雪花算法（Snowflake）因其结构简单、生成速度快、基本有序且不依赖数据库等优点，成为了许多Java项目的首选。而MyBatis-Plus作为MyBatis的增强工具，其内置的分布式ID生成器默认就采用了雪花算法，这为我们提供了开箱即用的便利。但“开箱即用”并不意味着我们可以完全当“甩手掌柜”。如果不理解其背后的机制、配置项以及潜在的坑，你可能会在遇到ID冲突、时钟回拨导致服务异常时束手无策。

这篇内容，我就结合自己多年在分布式项目中的实战经验，把MyBatis-Plus中雪花算法的使用掰开揉碎了讲清楚。从它的核心原理、如何配置、到生产环境必须考虑的机器ID分配、时钟回拨处理策略，以及如何根据自身业务进行定制化改造。无论你是刚开始接触MyBatis-Plus的新手，还是正在为线上ID问题排查的老手，相信都能从中找到需要的答案。

2. 雪花算法核心原理与MyBatis-Plus的实现拆解

要玩转一个工具，首先得理解它的内核。雪花算法之所以高效，源于其精巧的位分配设计。一个标准的64位长整型ID（Long），被划分成了几个部分，像一块瑞士手表一样精密协作。

2.1 算法位结构深度解析

一个典型的雪花ID是64位的Long类型数字，在Java中它看起来就是一个很大的整数。这个数字的内部结构是这样的：

1位符号位 ：固定为0，表示正数。这保证了生成的ID永远是正数。
41位时间戳 ：这是算法的核心。记录的是当前时间戳（毫秒级）减去一个自定义的起始时间戳（epoch）的差值。41位可以表示 2^41 - 1 毫秒，约等于69年。这意味着从你设定的起始时间算起，这个算法在未来69年内不会出现时间戳耗尽的问题。MyBatis-Plus默认的起始时间是 2020-01-01 。
10位工作机器ID ：这10位用来区分不同的机器或进程，是保证分布式环境下ID唯一性的关键。通常，这10位会进一步拆分为两部分，比如5位数据中心ID（datacenterId）和5位机器ID（workerId），这样最多可以支持 2^5 = 32 个数据中心，每个数据中心最多 2^5 = 32 台机器，总共1024个节点。MyBatis-Plus默认的实现中，将这10位统称为“机器ID”，并提供了多种策略来分配它。
12位序列号 ：在同一毫秒内，如果有多条记录需要生成ID，这个序列号就派上用场了。12位支持每台机器每毫秒生成 2^12 = 4096 个不重复的ID。当一毫秒内的请求超过4096时，算法会“等待”到下一毫秒再继续生成。

注意：这里有一个非常重要的细节。由于时间戳部分是高位，机器ID和序列号在低位，因此生成的ID整体上是 趋势递增 的。这对于数据库索引（如MySQL的InnoDB聚集索引）非常友好，能有效减少页分裂，提升写入性能。但它并不是严格单调递增的，因为如果系统时钟发生回拨，可能会生成比之前小的ID。

2.2 MyBatis-Plus的默认实现与关键类

MyBatis-Plus在 com.baomidou.mybatisplus.core.incrementer 包下提供了ID生成器的接口和实现。默认使用的就是 DefaultIdentifierGenerator ，其内部持有一个 DefaultIdGenerator 实例，这才是雪花算法的具体实现。

当你定义一个实体类，并在主键字段上使用 @TableId(type = IdType.ASSIGN_ID) 注解时（这也是MyBatis-Plus 3.x版本的默认主键策略），MyBatis-Plus在插入数据前，会自动调用这个生成器为你创建ID。

// 实体类示例
@Data
@TableName("user")
public class User {
    @TableId(type = IdType.ASSIGN_ID) // 使用雪花算法生成ID
    private Long id;
    private String name;
    // ... 其他字段
}

关键点在于 IdType.ASSIGN_ID 。与之容易混淆的是 IdType.ASSIGN_UUID ，后者会生成一个32位的字符串UUID。虽然UUID也是全局唯一的，但它无序且长度较长，不利于作为数据库主键索引。因此，在绝大多数需要高性能和有序性的场景下， ASSIGN_ID <