使用mybatisplus时 Cause: java.lang.IllegalStateException: Type handler was null on parameter mapping

在使用 MyBatis-Plus 进行数据库操作时，我们可能会遇到一些异常情况，其中之一就是 java.lang.IllegalStateException: Type handler was null on parameter mapping。这个异常通常是由于 MyBatis 在处理参数时无法找到合适的类型处理器（Type Handler）导致的。本文将详细解析出现该异常的原因及解决方案，并附带代码示例。

1. 异常分析

java.lang.IllegalStateException: Type handler was null on parameter mapping 这个异常一般是在执行 SQL 语句时，MyBatis 尝试将参数映射到 SQL 中时出现问题。具体来说，这种情况通常出现在以下几种情况：

• 参数类型未注册类型处理器：当传入参数的类型没有映射到相应的类型处理器时，就会导致此异常。MyBatis 需要知道如何处理该类型的参数，以便将其正确地转换为数据库可以理解的格式。

• 数据库字段类型与 Java 类型不匹配：如果数据库中的字段类型与 Java 对应的字段类型不匹配，也会导致 MyBatis 无法找到合适的类型处理器。

• 代码逻辑错误：有时在传递参数时，参数的值为 null，而 MyBatis 无法处理这个 null 值，也会引发该异常。

2. 解决方案

要解决这个问题，我们可以从以下几个方面入手：

2.1 确保参数类型正确

首先，在 Mapper 接口中定义正确的方法，确保参数的类型与数据库表中的字段类型一一对应。例如，如果数据库表中的字段是 Integer 类型，那么 Java 对应的字段也应为 Integer。

public interface UserMapper extends BaseMapper<User> {
    User getUserById(@Param("id") Integer id);
}

2.2 为自定义类型注册类型处理器

如果使用了自定义的 Java 类型，确保为该类型注册了对应的 TypeHandler。例如，如果你的项目中使用了一个自定义的 Enum 类型，可以为这个 Enum 创建一个类型处理器。

@MappedTypes(MyEnum.class)
public class MyEnumTypeHandler extends BaseTypeHandler<MyEnum> {

    @Override
    public void setNonNullParameter(PreparedStatement ps, int i, MyEnum parameter, JdbcType jdbcType) throws SQLException {
        ps.setInt(i, parameter.getValue());
    }

    @Override
    public MyEnum getNullableResult(ResultSet rs, String columnName) throws SQLException {
        int value = rs.getInt(columnName);
        return MyEnum.fromValue(value);
    }

    @Override
    public MyEnum getNullableResult(ResultSet rs, int columnIndex) throws SQLException {
        int value = rs.getInt(columnIndex);
        return MyEnum.fromValue(value);
    }

    @Override
    public MyEnum getNullableResult(CallableStatement cs, int columnIndex) throws SQLException {
        int value = cs.getInt(columnIndex);
        return MyEnum.fromValue(value);
    }
}

然后在 mybatis-config.xml 中注册这个类型处理器：

<typeHandlers>
    <typeHandler handler="com.example.MyEnumTypeHandler" javaType="com.example.MyEnum"/>
</typeHandlers>

2.3 检查 SQL 语句

确保你的 SQL 语句没有错误，特别是参数的占位符（?）与方法参数的顺序要一致。如果是在 XML 配置文件中定义 SQL，确保参数名称和 Mapper 接口中定义的参数名称一致。

<select id="getUserById" resultType="User">
    SELECT * FROM user WHERE id = #{id}
</select>

3. 示例

以下是一个完整的示例。

// User.java
public class User {
    private Integer id;
    private String name;

    // getters and setters
}

// UserMapper.java
public interface UserMapper extends BaseMapper<User> {
    User getUserById(@Param("id") Integer id);
}

// UserService.java
@Service
public class UserService {
    @Autowired
    private UserMapper userMapper;

    public User findUserById(Integer id) {
        return userMapper.getUserById(id);
    }
}

// MybatisConfig.java
@Configuration
@MapperScan("com.example.mapper")
public class MybatisConfig {
    // 配置 MyBatis 相关信息
}

// application.properties
mybatis-plus.mapper-locations=classpath*:mapper/*.xml

结论

在使用 MyBatis-Plus 的过程中，遇到 java.lang.IllegalStateException: Type handler was null on parameter mapping 异常时，需要仔细检查参数类型、SQL 语句以及自定义类型的类型处理器。通过合理的配置和对参数处理的理解，大多数情况下可以顺利解决此类问题。希望本文对您有帮助，能更好地使用 MyBatis-Plus 进行开发。