### Cause: java.lang.ClassCastException org.mybatis.spring.MyBatisSystemException: nested exception is org.apache.ibatis.exceptions.PersistenceException: ### Error querying database. Cause: java.lang.ClassCastException ### Cause: java.lang.ClassCastException at org.mybatis.spring.MyBatisExceptionTranslator.translateExceptionIfPossible(MyBatisExceptionTranslator.java:96) at org.mybatis.spring.SqlSessionTemplate$SqlSessionInterceptor.invoke(SqlSessionTemplate.java:441) at com.sun.proxy.$Proxy157.selectOne(Unknown Source) at org.mybatis.spring.SqlSessionTemplate.selectOne(SqlSessionTemplate.java:160) at com.baomidou.mybatisplus.core.override.MybatisMapperMethod.execute(MybatisMapperMethod.java:89) at com.baomidou.mybatisplus.core.override.MybatisMapperProxy$PlainMethodInvoker.invoke(MybatisMapperProxy.java:148) at com.baomidou.mybatisplus.core.override.MybatisMapperProxy.invoke(MybatisMapperProxy.java:89) at com.sun.proxy.$Proxy172.selectById(Unknown Source)

<think>我们正在解决MyBatis查询数据库时发生的ClassCastException异常。首先，我们需要理解这个异常的原因。ClassCastException通常发生在试图将一个对象强制转换为不是其实例的类时。在MyBatis的上下文中，这通常与映射结果有关，可能是以下几种情况： 1. **结果映射错误**：MyBatis在将数据库查询结果映射到Java对象时，可能因为映射配置不正确（如`resultMap`或`resultType`）导致类型不匹配。 2. **查询返回类型不匹配**：在XML映射文件或注解中指定的返回类型与实际查询返回的结果类型不一致。 3. **数据库字段与Java属性类型不一致**：数据库字段类型与Java对象属性类型不匹配，例如数据库返回的是字符串，而Java对象属性是整数。 4. **使用集合时的泛型问题**：如果返回的是集合（如List），而集合中的元素类型与期望的类型不匹配。 5. **自动映射导致的类型错误**：当使用自动映射（没有明确配置resultMap）时，MyBatis可能无法正确推断类型，尤其是当数据库字段名与Java属性名不完全匹配时。 接下来，我们逐步排查和解决： ### 1. 检查映射配置 首先，检查你的映射文件（如Mapper XML）或注解中是否正确定义了结果映射。确保`resultType`或`resultMap`属性设置正确。 - 如果使用`resultType`，它应该是一个完全限定的Java类名（或别名），并且该类必须与查询返回的每一行数据相匹配。 - 如果使用`resultMap`，确保在`resultMap`中正确定义了列到属性的映射。 例如，在XML中： ```xml <select id="selectUser" resultType="com.example.User"> SELECT id, name, age FROM user WHERE id = #{id} </select> ``` 这里，`com.example.User`类应该具有与查询列（id, name, age）对应的属性（具有相同的名称或符合驼峰命名规则，如果配置了自动驼峰映射）。 ### 2. 验证返回类型 确保你的Mapper接口方法声明的返回类型与映射配置一致。例如： ```java public interface UserMapper { User selectUserById(int id); } ``` 如果查询返回多个结果，但方法声明为单个对象，也会导致问题。同样，如果查询返回单个值，但方法声明为集合，也会有问题。 ### 3. 检查数据库字段与Java属性类型 比较数据库表字段类型和Java对象属性类型是否兼容。例如，数据库中的`VARCHAR`映射到Java的`String`，`INT`映射到`Integer`等。如果不匹配，MyBatis在尝试转换时可能会抛出ClassCastException。 ### 4. 集合的泛型类型 如果返回的是集合，确保集合的泛型类型正确。例如： ```java List<User> selectUsers(); ``` 在XML中，`resultType`应该是集合元素的类型，而不是集合本身： ```xml <select id="selectUsers" resultType="com.example.User"> SELECT * FROM user </select> ``` ### 5. 使用显式映射（resultMap） 为了避免自动映射可能带来的问题，建议使用显式的`resultMap`。在`resultMap`中，你可以指定每个列对应的属性和类型，以及必要的类型处理器（typeHandler）。 例如： ```xml <resultMap id="userResultMap" type="com.example.User"> <id property="id" column="id" /> <result property="name" column="name" /> <result property="age" column="age" /> </resultMap> <select id="selectUser" resultMap="userResultMap"> SELECT id, name, age FROM user WHERE id = #{id} </select> ``` ### 6. 检查日志 启用MyBatis的日志（设置日志级别为DEBUG）可以查看MyBatis执行的SQL以及返回的结果集。这有助于发现类型不匹配的地方。 ### 7. 类型处理器（TypeHandler） 如果遇到特殊类型（如枚举、自定义类型等），确保有相应的类型处理器。如果没有，可能需要自定义类型处理器。 ### 8. 其他可能的原因 - 多表关联查询时，如果使用了复杂的映射（如association或collection），也可能因为嵌套类型错误导致。 - 使用`Map`作为结果类型时，虽然不会出现ClassCastException，但如果你试图将整个结果转换为一个对象，而实际上返回的是多个对象，则可能出错。 ### 解决方案总结 1. **仔细检查映射配置**：确保`resultType`或`resultMap`正确，并且与Mapper接口方法返回类型一致。 2. **使用显式resultMap**：避免自动映射可能带来的问题。 3. **检查数据库字段与Java属性类型**：确保类型兼容。 4. **查看MyBatis日志**：获取更详细的错误信息。 5. **自定义类型处理器**：处理特殊类型转换。 如果以上步骤仍不能解决问题，请提供具体的错误堆栈信息、相关代码（Mapper接口、XML映射文件、POJO类）以及数据库表结构，以便进一步分析。 §§相关问题§§ 1. MyBatis中如何配置和使用自定义类型处理器（TypeHandler）？ 2. MyBatis的resultMap和resultType有什么区别？ 3. 如何启用MyBatis的日志以查看执行的SQL和结果？ 4. 在MyBatis中如何处理多表关联查询的结果映射？</think>### MyBatis查询时ClassCastException异常分析与解决方案 #### 问题原因 ClassCastException通常发生在MyBatis将数据库查询结果映射到Java对象时，类型转换失败。常见原因包括： 1. **映射配置错误** - `resultType`或`resultMap`指定类型与实际返回类型不匹配 - 集合类型未正确声明泛型（如`List<User>`误配为`List`） - 多表关联查询时嵌套映射错误 2. **类型处理器(TypeHandler)失效** - 自定义类型处理器未注册或逻辑错误 - 数据库字段类型与Java属性类型不兼容（如将`VARCHAR`映射为`Integer`） 3. **SQL返回结构问题** - 查询返回列数与Java对象属性数不一致 - 使用`UNION`等操作导致返回类型动态变化 - 存储过程返回多个结果集未正确处理 4. **MyBatis版本兼容性问题** 某些版本存在类型推断缺陷（如3.4.x到3.5.x的兼容性变化）[^1] #### 解决方案 ##### 1. 检查映射配置（关键步骤） ```xml <!-- 错误示例：resultType未指定泛型 --> <select id="getUsers" resultType="java.util.List"> ❌ SELECT * FROM users </select> <!-- 正确配置：明确泛型类型 --> <select id="getUsers" resultType="com.example.User"> ✅ SELECT id, name, age FROM users </select> <!-- 复杂映射使用resultMap --> <resultMap id="userMap" type="User"> <id property="id" column="user_id"/> <result property="userName" column="name"/> <!-- 注意字段别名匹配 --> <association property="dept" javaType="Department">...</association> </resultMap> ``` ##### 2. 验证类型处理器 注册自定义类型处理器： ```xml <!-- mybatis-config.xml --> <typeHandlers> <typeHandler handler="com.example.MyDateTypeHandler" jdbcType="TIMESTAMP" javaType="java.time.LocalDateTime"/> </typeHandlers> ``` 实现逻辑示例： ```java public class MyDateTypeHandler extends BaseTypeHandler<LocalDateTime> { @Override public void setNonNullParameter(PreparedStatement ps, int i, LocalDateTime param, JdbcType jdbcType) { ps.setTimestamp(i, Timestamp.valueOf(param)); } @Override public LocalDateTime getNullableResult(ResultSet rs, String col) throws SQLException { Timestamp timestamp = rs.getTimestamp(col); return timestamp != null ? timestamp.toLocalDateTime() : null; } } ``` ##### 3. 调试SQL返回结构 - 在数据库客户端直接执行SQL，检查返回的字段类型 - 添加结果类型检查代码： ```java List<?> rawList = sqlSession.selectList("queryName"); if(!rawList.isEmpty()) { Object firstItem = rawList.get(0); logger.info("Actual return type: {}", firstItem.getClass()); // 打印实际类型 } ``` ##### 4. 版本兼容性处理 若从旧版升级到MyBatis 3.5+： ```java // 手动注册类型别名的替代方案（旧版兼容） @Alias("User") public class UserDTO { ... } // 在配置中显式声明 <typeAliases> <typeAlias type="com.example.UserDTO" alias="User"/> </typeAliases> ``` #### 预防措施 1. **严格类型检查** ```java // Mapper接口声明精确返回类型 public interface UserMapper { @MapKey("id") // 明确Map的key类型 Map<Integer, User> getUserMap(); } ``` 2. **启用MyBatis日志** ```xml <settings> <setting name="logImpl" value="SLF4J"/> <setting name="callSettersOnNulls" value="true"/> <!-- 避免NPE --> </settings> ``` 3. **单元测试验证** ```java @Test public void testResultType() { User user = userMapper.getUserById(1); assertThat(user).isInstanceOf(User.class); // 使用AssertJ验证类型 } ``` > **重要提示**：若使用XML元素自动映射，建议迁移到注解POJO方式，新版MyBatis已提供更健壮的类型推导机制[^1]。