Mybatis——关于实体构造函数与Mybatis字段映射的坑

现象

今天一位同事找我看一个很奇怪的问题：
执行一个单表的查询语句，结果老是报字段类型不匹配的错误，错误日志如下：

Servlet.service() for servlet [dispatcherServlet] in context with path [] threw exception [Request processing failed; nested exception is org.springframework.dao.DataIntegrityViolationException: Error attempting to get column 'user_name' from result set.  Cause: java.sql.SQLDataException: Cannot convert string 'admin' to java.sql.Timestamp value
; Cannot convert string 'admin' to java.sql.Timestamp value; nested exception is java.sql.SQLDataException: Cannot convert string 'admin' to java.sql.Timestamp value] with root cause

com.mysql.cj.exceptions.DataConversionException: Cannot convert string 'admin' to java.sql.Timestamp value
	at com.mysql.cj.result.AbstractDateTimeValueFactory.createFromBytes(AbstractDateTimeValueFactory.java:123) ~[mysql-connector-java-8.0.21.jar:8.0.21]
	at com.mysql.cj.protocol.a.MysqlTextValueDecoder.decodeByteArray(MysqlTextValueDecoder.java:134) ~[mysql-connector-java-8.0.21.jar:8.0.21]
	at com.mysql.cj.protocol.result.AbstractResultsetRow.decodeAndCreateReturnValue(AbstractResultsetRow.java:133) ~[mysql-connector-java-8.0.21.jar:8.0.21]
	at com.mysql.cj.protocol.result.AbstractResultsetRow.getValueFromBytes(AbstractResultsetRow.java:241) ~[mysql-connector-java-8.0.21.jar:8.0.21]

实体文件：

@Builder
@Data
@Table(name = "sys_logininfor")
public class SysLogininfor implements Serializable
{
    private static final long serialVersionUID = 1L;

    @Id
    private Long infoId;

    /** 访问时间 */
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
    private Date accessTime;

    /** 用户账号 */
    private String userName;

    /** 状态 0成功 1失败 */
    private String status;

    /** 地址 */
    private String ipaddr;

    /** 描述 */
    private String msg;



}

字段类型，也没有问题，

问题分析

问题来了，咱不怕啊，运行代码，就开始排查呗
经过分析，发现mybatis里的ResultSetHandler里的类型不匹配造成的，把一个字符串类型的结果当成日期类型了，报错行如下：

private Object createUsingConstructor(ResultSetWrapper rsw, Class<?> resultType, List<Class<?>> constructorArgTypes, List<Object> constructorArgs, Constructor<?> constructor) throws SQLException {
        boolean foundValues = false;

        for(int i = 0; i < constructor.getParameterTypes().length; ++i) {
            Class<?> parameterType = constructor.getParameterTypes()[i];
            String columnName = (String)rsw.getColumnNames().get(i);
            TypeHandler<?> typeHandler = rsw.getTypeHandler(parameterType, columnName);
            Object value = typeHandler.getResult(rsw.getResultSet(), columnName);//在该行，将user_name的值，往access_time上匹配，所以报错
            constructorArgTypes.add(parameterType);
            constructorArgs.add(value);
            foundValues = value != null || foundValues;
        }

        return foundValues ? this.objectFactory.create(resultType, constructorArgTypes, constructorArgs) : null;
    }

分析到这，还是不能知道原因，为什么会把不同的字段的类型错误匹配呢？

再一步步的跟源码，发现，在createResultObject这个方法中，有古怪，匹配字段类型，从这个地方开始的，(!resultType.isInterface() && !metaType.hasDefaultConstructor()) {//在该行，debug得知，实体没有默认构造函数会进此分支，导致使用构造函数中的字段顺序与sql结果中的字段顺序进行强行匹配

private Object createResultObject(ResultSetWrapper rsw, ResultMap resultMap, List<Class<?>> constructorArgTypes, List<Object> constructorArgs, String columnPrefix) throws SQLException {
        Class<?> resultType = resultMap.getType();
        MetaClass metaType = MetaClass.forClass(resultType, this.reflectorFactory);
        List<ResultMapping> constructorMappings = resultMap.getConstructorResultMappings();
        if (this.hasTypeHandlerForResultObject(rsw, resultType)) {
            return this.createPrimitiveResultObject(rsw, resultMap, columnPrefix);
        } else if (!constructorMappings.isEmpty()) {
            return this.createParameterizedResultObject(rsw, resultType, constructorMappings, constructorArgTypes, constructorArgs, columnPrefix);
        } else if (!resultType.isInterface() && !metaType.hasDefaultConstructor()) {
        //在该行，debug得知，实体没有默认构造函数会进此分支，导致使用构造函数中的字段顺序与sql结果中的字段顺序进行强行匹配
            if (this.shouldApplyAutomaticMappings(resultMap, false)) {
                return this.createByConstructorSignature(rsw, resultType, constructorArgTypes, constructorArgs);
            } else {
                throw new ExecutorException("Do not know how to create an instance of " + resultType);
            }
        } else {
            return this.objectFactory.create(resultType);
        }
    }

再看实体类，因为使用了lombok，所以只能通过工具查看

竟然只有一个带参数的构造函数，没有无参数的默认构造函数 再看实体上的注解，原来是加了Builder导致的，那增加一个无参数注解试试，@NoArgsConstructor 这个时候，默认无参数的构造函数出来了。 再重新启动系统，一切运行正常。 问题解决。

问题原因

1. 实体中没有生成不带参数的默认构造函数；
2. 实体中的字段顺序与SQL语句中的Select的字段顺序不一致；

上述两个巧合凑在一起了，结果导致触发了mybatis的这个坑，如果使用mybatis自带的Example或者Wrapper等封装类。，也不会出现这个问题。

问题总结

1. 完全使用实体中的配置，并且使用Example或者Wrapper等封装类，
2. 生成实体类的时候，如果使用lombok来配置的话，需要增加不带任何参数的默认构造函数@NoArgsConstructor