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

在使用 MyBatis-Plus 进行数据库操作时，主键生成策略是一个重要的概念。MyBatis-Plus 提供了多种主键生成策略，通过注解 @TableId 来配置，其中 IdType.AUTO 是最常用的一种。本文将详细介绍 @TableId(type = IdType.AUTO) 的使用方法，特别是当主键字段不是 id 时如何指定，并与其他主键生成策略进行比较。

一、@TableId(type = IdType.AUTO) 介绍

@TableId 是 MyBatis-Plus 用于标识数据库表主键字段的注解。IdType.AUTO 是其中的一种主键生成策略，表示数据库表的主键字段采用自增策略，即由数据库自动生成主键值。

使用方法

1. 基本用法：

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

   上述代码表示字段 id 是自增主键，由数据库自动生成值。

2. 非 id 字段作为主键：

   当主键字段不是 id 时，可以使用 @TableId 指定主键字段，并且设置其类型为 AUTO：

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

   这里的 value 参数指定了主键字段的名称 custom_id，同时设置 type 为 IdType.AUTO 表示自增主键。

适用场景

IdType.AUTO 适用于主键值由数据库自动生成的场景，通常是在数据库表设计中主键字段被设置为自增。

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

MyBatis-Plus 提供了多种主键生成策略，通过 IdType 枚举来配置。以下是 IdType.AUTO 与其他几种常用策略的比较：

1. IdType.NONE

• 描述：未设置主键生成策略，默认由数据库自行处理。

• 使用方法：

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

• 适用场景：主键值在插入数据时明确指定，由应用程序或数据库触发器等负责生成。

2. IdType.INPUT

• 描述：手动输入，由用户在插入数据时指定主键值。

• 使用方法：

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

• 适用场景：适用于主键由外部系统或用户输入的情况，例如业务上需要指定特定的主键值。

3. IdType.ID_WORKER 和 IdType.ID_WORKER_STR

• 描述：使用分布式主键生成器生成全局唯一 ID，前者生成数字类型，后者生成字符串类型。

• 使用方法：

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

• 适用场景：适用于分布式系统，要求主键全局唯一且无冲突，例如分布式数据库或微服务架构下的数据存储。

4. IdType.UUID

• 描述：生成 32 位 UUID 字符串作为主键。

• 使用方法：

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

• 适用场景：适用于需要字符串类型主键且要求全局唯一的场景，例如一些特定业务需要用 UUID 作为标识符。

5. IdType.ASSIGN_ID

• 描述：雪花算法生成的 19 位数字类型主键。

• 使用方法：

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

• 适用场景：与 IdType.ID_WORKER 类似，适用于分布式系统需要全局唯一主键的情况。

6. IdType.ASSIGN_UUID

• 描述：生成 32 位 UUID 字符串作为主键，与 IdType.UUID 类似，但使用不同的生成算法。

• 使用方法：

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

• 适用场景：同 IdType.UUID，适用于需要字符串类型主键且要求全局唯一的场景。

三、总结

在使用 MyBatis-Plus 时，选择适当的主键生成策略是非常重要的。@TableId(type = IdType.AUTO) 适用于主键由数据库自动生成的场景，特别是在数据库设计中主键字段设置为自增时非常方便。而其他主键生成策略则适用于不同的业务需求，例如分布式系统、需要手动指定主键等。

希望本文能帮助你更好地理解和使用 @TableId(type = IdType.AUTO) 及其他主键生成策略。在实际项目中，根据具体需求选择合适的主键生成策略，才能更好地保证数据的一致性和完整性。