Mybatis Plus主键策略踩坑-ID_WORKER无法自动生成主键值

Mybatis Plus 版本 3.2.0

Mybatis Plus的主键策略

Mybatis Plus的主键策略有如下几种：

AUTO 数据库ID自增
使用AUTO策略时，数据库建表时需要将主键设置成AUTO_INCREMENT,否则会插入不了
INPUT 用户输入ID
用户输入ID
ID_WORKER 全局唯一ID，Long类型的主键
全局唯一ID，Long类型的主键
ID_WORKER_STR 字符串全局唯一ID
字符串全局唯一ID
UUID 全局唯一ID，UUID类型的主键
UUID类型的主键
NONE 该类型为未设置主键类型
该类型为未设置主键类型

问题描述

这里以AUTO主键策略来演示遇到的问题

实体类Student

@TableName("tb_student")
public class Student implements Serializable{
    private static final long serialVersionUID = 1L;
    @TableId(value = "student_id", type = IdType.ID_WORKER)
    private long studentId;
    @TableField(value = "student_age")
    private int studentAge;
    @TableField(value = "student_name")
    private String studentName;
    @TableField(value = "student_sex")
    private int studentSex;
    //getter and setter
}

Mapper等省略
测试程序如下：

@RunWith(SpringRunner.class)
@SpringBootTest
@FixMethodOrder(MethodSorters.NAME_ASCENDING)
public class StudentMapperTest {
    @Autowired
    StudentMapper studentMapper;
    @Test
    public void testInsert(){
        Student student = new Student();
        student.setStudentAge(20);
        //1表示男，2表示女
        student.setStudentSex(1);
        student.setStudentName("愤怒的小猿");
        studentMapper.insert(student);
    }
}

运行测试代码，第一次插入进了数据库，在运行一次，发现数据插入到了数据库，在运行一次发现报错了，日志如下：

 Cause: com.mysql.jdbc.exceptions.jdbc4.MySQLIntegrityConstraintViolationException: Duplicate entry '0' for key 'PRIMARY'
; Duplicate entry '0' for key 'PRIMARY'; nested exception is com.mysql.jdbc.exceptions.jdbc4.MySQLIntegrityConstraintViolationException: Duplicate entry '0' for key 'PRIMARY'
	at org.springframework.jdbc.support.SQLErrorCodeSQLExceptionTranslator.doTranslate(SQLErrorCodeSQLExceptionTranslator.java:242)
	at org.springframework.jdbc.support.AbstractFallbackSQLExceptionTranslator.translate(AbstractFallbackSQLExceptionTranslator.java:72)
	at org.mybatis.spring.MyBatisExceptionTranslator.translateExceptionIfPossible(MyBatisExceptionTranslator.java:74)
	at org.mybatis.spring.SqlSessionTemplate$SqlSessionInterceptor.invoke(SqlSessionTemplate.java:440)
	at com.sun.proxy.$Proxy87.insert(Unknown Source)
	at org.mybatis.spring.SqlSessionTemplate.insert(SqlSessionTemplate.java:271)

意思是说主键重复了，我们这里的策略使用的是ID_WORKER，应该会自动生成才对，为什么没有自动生成主键呢？

问题分析

Mybatis Plus的主键值是通过IdWorker这个类生成的,通过对代码的跟踪，到MybatisDefaultParameterHandler的如下位置

这里studentId字段的额值是0，但是在179行判断的时候使用的是checkValNull()方法，因为0!=null，所以不会进入主键值的生成。
那么问题来了，这个0是哪来的呢。后来再看Student这个类的时候才发现,studentId的类型是long，long的默认值是0。所以这里才变成了0.