深入理解 `@TableId(type = IdType.AUTO)`：使用方法及其与其他主键生成策略的区别

在MyBatis-Plus（简称MP）中，@TableId 注解是用来标注实体类中主键的字段的，而 type = IdType.AUTO 是一个常见的配置选项，它指定了主键的生成策略。在实际开发中，如何配置主键生成策略对数据库的性能和稳定性有着重要影响。本文将深入探讨 @TableId(type = IdType.AUTO) 的使用方法，以及它与其他主键生成策略（如 IdType.INPUT、IdType.UUID 等）的区别和适用场景。

一、什么是 `@TableId` 注解？

在 MyBatis-Plus 中，@TableId 注解用于指定实体类中的主键字段。通常情况下，主键字段需要具有唯一性，而且数据库会根据该字段的值来区分每一条记录。

@TableId(value = "id", type = IdType.AUTO)
private Long id;

在上面的代码中，@TableId 被用来标注 id 字段是表的主键。value 属性指定了数据库表中的字段名，而 type 属性指定了主键的生成策略。

二、`@TableId(type = IdType.AUTO)` 的使用方法

IdType.AUTO 表示主键由数据库自动生成，通常与自增长字段一起使用。这意味着，主键的值在插入时由数据库自增，而不是由程序代码显式指定。

常见的数据库支持：

MySQL：AUTO_INCREMENT
PostgreSQL：SERIAL
Oracle：SEQUENCE

代码示例

假设我们有一个实体类 User，我们希望在插入数据时由数据库自动生成主键：

@Data
@TableName("user")
public class User {@TableId(type = IdType.AUTO) // 自动生成主键private Long id;private String name;private Integer age;
}

对于上述实体类，当我们执行 userMapper.insert(user) 时，id 字段会被数据库自动填充（通常是自增长）。

三、与其他主键生成策略的区别

MyBatis-Plus 提供了多种主键生成策略，具体配置如下：

1. `IdType.AUTO`（数据库自增）

@TableId(type = IdType.AUTO) 配置表示主键由数据库自动生成。适用于支持自动增量字段的数据库，如 MySQL 的 AUTO_INCREMENT、PostgreSQL 的 SERIAL 等。

优点：

简单易用，数据库自动处理主键。
避免了手动生成主键的麻烦。

缺点：

主键生成依赖数据库，某些数据库可能存在性能瓶颈（如高并发时自增主键可能引发争用问题）。
对于分布式系统来说，可能需要额外的处理（如数据库分库分表时，可能会导致主键冲突或性能问题）。

2. `IdType.INPUT`（手动输入）

@TableId(type = IdType.INPUT) 配置表示主键由开发者手动输入，程序员需要在插入数据时显式指定主键值。

@TableId(type = IdType.INPUT)
private Long id;

优点：

适合主键需要特定值的情况（如UUID或业务逻辑生成的主键）。
适用于需要从外部系统传入主键的场景。

缺点：

需要手动生成主键，增加了开发的复杂性和错误的风险。
可能需要额外的处理来确保主键的唯一性，尤其是在分布式系统中。

3. `IdType.UUID`（UUID）

@TableId(type = IdType.UUID) 配置表示主键由 UUID（通用唯一识别码）生成。这是一个跨平台、全局唯一的标识符。

@TableId(type = IdType.UUID)
private String id;

优点：

主键具有全局唯一性，适合分布式系统。
不依赖数据库的自增长特性，避免了数据库主键生成的限制。

缺点：

UUID 是一串字符串，长度较长，可能导致数据库存储的空间浪费。
在性能上可能不如自增主键，尤其是在大量数据插入时，UUID 生成和查询速度相对较慢。

4. `IdType.ID_WORKER`（雪花算法）

@TableId(type = IdType.ID_WORKER) 配置表示主键使用雪花算法生成。雪花算法是一种分布式ID生成算法，确保在分布式环境下每个服务生成的主键唯一且递增。

@TableId(type = IdType.ID_WORKER)
private Long id;

优点：

生成的ID具有唯一性和有序性，适合分布式环境。
雪花算法生成的ID为数字类型，性能较好。

缺点：

雪花算法需要额外的配置和分布式协调。
如果服务之间的时钟不一致，可能会产生主键重复的问题。

5. `IdType.ASSIGN_UUID`（分布式 UUID）

@TableId(type = IdType.ASSIGN_UUID) 配置表示主键为分布式的 UUID，通常与分布式系统搭配使用，确保不同节点生成的主键不会冲突。

@TableId(type = IdType.ASSIGN_UUID)
private String id;

优点：

保证跨系统、跨机器的唯一性。
在分布式系统中尤其有用。

缺点：

UUID 长度较长，可能会影响查询性能。
不适合大量数据插入时的高效生成主键。

四、如何选择合适的主键生成策略？

选择合适的主键生成策略，通常取决于以下几个因素：

单体应用或分布式系统：
- 如果是单体应用，IdType.AUTO（数据库自增）通常是最简单、最有效的选择。
- 如果是分布式系统，IdType.UUID 或 IdType.ID_WORKER 更适合，因为它们能确保不同节点生成的主键唯一。
性能需求：
- IdType.AUTO 在性能上可能会受到数据库锁机制的影响，在高并发场景下可能不如雪花算法（IdType.ID_WORKER）或 UUID（IdType.UUID）性能好。
主键的唯一性：
- 如果需要确保全局唯一，尤其是在分布式系统中，UUID 和雪花算法是更好的选择。
业务需求：
- 如果主键需要根据业务规则自定义，使用 IdType.INPUT 是最合适的。