mybatis使用LocalDate和LocalDateTime抛出异常 java.lang.IllegalStateException: Type handler was null

本文介绍了如何在MyBatis中处理JSR310新日期时间API如Instant、LocalDateTime等类型的转换。通过引入mybatis-typehandlers-jsr310库，并配置TypeHandlers，可以解决MyBatis与Java8日期时间类型的兼容问题。当MyBatis版本低于3.4.0时，需要手动配置TypeHandler。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

1.解决方法：
引入jar包

<dependency> 
 <groupId>org.mybatis</groupId> 
 <artifactId>mybatis-typehandlers-jsr310</artifactId> 
 <version>1.0.1</version> 
</dependency>

若使用的mybatis版本低于3.4.0，则需要配置：

<typeHandlers> 
 <typeHandler handler="org.apache.ibatis.type.InstantTypeHandler" /> 
 <typeHandler handler="org.apache.ibatis.type.LocalDateTimeTypeHandler" /> 
 <typeHandler handler="org.apache.ibatis.type.LocalDateTypeHandler" /> 
 <typeHandler handler="org.apache.ibatis.type.LocalTimeTypeHandler" /> 
 <typeHandler handler="org.apache.ibatis.type.OffsetDateTimeTypeHandler" /> 
 <typeHandler handler="org.apache.ibatis.type.OffsetTimeTypeHandler" /> 
 <typeHandler handler="org.apache.ibatis.type.ZonedDateTimeTypeHandler" /> 
</typeHandlers>

2.原因分析：
TypeHandler是MyBatis中的类型转换器，用于Java对象和JDBC的相互转换。

MyBatis使用PrepareStatement来进行参数设置的时候,需要通过TypeHandler将传入的java参数设置成合适的jdbc类型参数,这个过程实际上是通过调用PrepareStatement不同的setParameter方法实现的；在获取结果返回之后,也需要将返回的结果转换成我们需要的java类型,这时候是通过调用ResultSet对象不同类型的getResult方法;所以不同类型的typeHandler其实就是调用PrepareStatement和ResultSet的不同方法来进行类型的转换,有些时候会在调用PrepareStatement和ResultSet的相关方法之前,可以对传入的参数进行一定的处理。

当我们没有指定typeHandler的时候mybatis会根据传入参数的类型和返回值的类型调用默认的typeHandler进行处理。对于一个typeHandler需要配置java类型(javaType)和JDBC类型(jdbcType)，typeHandler的作用就是实现这两种类型的转换，在传入的参数为指定的Java类型时，将其转换为指定的JDBC类型，当返回值为指定JDBC类型时将其转换为配置的Java类型。