解决方法
先说我的解决方法,感兴趣读者可以看下面的解决过程。我出现此错误是因为我在UserMapper.xml中写了Mapper接口没有的方法,所以导致初始化时找不到,正确的做法只要在Mapper接口中补齐xml文件中的sql方法,或者将xml文件中的sql方法删除即可。
解决过程
报错信息:
Result Maps collection does not contain value for com.xszx.beans.User
先翻译此错误:结果映射集合不包含com.xszx.beans.User的值
因为我有写一个resultMap结果集,所以我一直以为是不同的名字对应错误,于是开始一步步对照,首先是maven的依赖,在确定自己导入了需要的包之后,先去排查mybatis-config配置文件,确保映射的地址是正确的
<!--配置mybatis的映射文件-->
<mappers>
<mapper resource="dao/UserMapper.xml"></mapper>
</mappers>
然后在看地址UserMapper文件的空间地址是否正确
<mapper namespace="com.xszx.dao.UserMapper">
最后又将结果集的每一行内容跟我的数据库对应,排查了好几遍,但是一直是出不来。
<resultMap id="userResultMap" type="com.xszx.beans.User">
<id property="id" column="id" />
<result property="name" column="name" />
<result property="loginname" column="loginname" />
<result property="pwd" column="pwd" />
<result property="sex" column="sex" />
<result property="age" column="age" />
<result property="hobby" column="hobby" />
<!-- 其他User属性映射 -->
<association property="role" javaType="com.xszx.beans.Role">
<id property="id" column="rid" />
<result property="name" column="rname" />
</association>
</resultMap>
<select id="login" resultMap="userResultMap">
SELECT u.*, r.id rid, r.name rname
FROM user u
LEFT JOIN user_role ur ON u.id = ur.uid
LEFT JOIN role r ON r.id = ur.rid
WHERE u.loginname = #{name}
AND u.pwd = #{pwd}
</select>
最后无奈新创建了一个项目,然后重新写了一遍,这次写一步运行一步,终于找到问题的关键了,后来去网上查了相关的原因。
这个问题的核心在于 MyBatis 的映射配置和接口方法的一致性。MyBatis 通过 Mapper 接口和对应的 XML 文件来定义 SQL 语句和结果映射。
-
方法未在接口中定义:如果你在 XML 文件中定义了某个方法(例如
selectUserById
),但这个方法并没有在对应的 Mapper 接口中声明,MyBatis 在初始化时会找不到对应的方法定义,从而导致错误。 -
方法签名不匹配:即使方法在接口中声明了,如果方法的参数类型、返回类型或方法名与 XML 文件中的定义不匹配,也会导致 MyBatis 无法正确映射。
MyBatis 在初始化时无法处理那些未在接口中声明的方法。
为了确保 MyBatis 能够正确映射,应该:
-
确保接口和 XML 文件一致:在 Mapper 接口中声明的所有方法都应该在对应的 XML 文件中有相应的 SQL 语句。
-
检查方法签名:确保接口中的方法签名(方法名、参数类型、返回类型)与 XML 文件中的定义完全一致。
-
正确配置 MyBatis:确保 MyBatis 配置文件中正确加载了所有的 Mapper 文件。
例如,假设你的 Mapper 接口如下:
// UserMapper.java
package com.xszx.mapper;
import com.xszx.beans.User;
public interface UserMapper {
User login(String username, String password);
}
对应的 XML 文件应该如下:
<!-- UserMapper.xml -->
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.xszx.mapper.UserMapper">
<!-- 定义 ResultMap -->
<resultMap id="UserResultMap" type="com.xszx.beans.User">
<id property="id" column="id"/>
<result property="username" column="username"/>
<result property="email" column="email"/>
<!-- 其他字段 -->
</resultMap>
<!-- 查询语句 -->
<select id="login" resultMap="UserResultMap">
SELECT id, username, email FROM users WHERE username = #{username} AND password = #{password}
</select>
</mapper>
如果你在mapper.xml文件中新增加了Mapper接口中没有的方法,那么你就会报此错误。