如何解决 MyBatis 中的 PersistenceException: Mapped Statements collection does not contain value for mapper

在使用 MyBatis 框架处理数据库操作时，可能会遇到 PersistenceException 异常，其中一个常见的原因是 MyBatis 无法找到与指定的 Mapper 接口方法对应的映射语句。本文将详细介绍这种异常的原因以及如何解决它。

异常描述

在执行 MyBatis 数据库操作时，如果出现以下异常：

1org.apache.ibatis.exceptions.PersistenceException: 
2### Error querying database.  Cause: java.lang.IllegalArgumentException: Mapped Statements collection does not contain value for mapper.AdminMapper.admin_Login

这通常意味着 MyBatis 无法找到与 AdminMapper 接口中 admin_Login 方法对应的 <select> 语句。这种情况下，我们需要检查 AdminMapper.xml 文件中是否正确定义了该方法对应的 SQL 查询语句。

解决步骤

1. 检查 XML 映射文件

确保 AdminMapper.xml 文件中包含了一个与 AdminMapper 接口中 admin_Login 方法相对应的 <select> 语句。例如：

1<?xml version="1.0" encoding="UTF-8" ?>
2<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
3<mapper namespace="com.example.mapper.AdminMapper">
4    <select id="admin_Login" resultType="Model.AdminModel">
5        SELECT * FROM administrator WHERE adminName = #{adminName} AND adminPwd = #{adminPwd}
6    </select>
7</mapper>

2. 检查 Mapper 接口

确保 AdminMapper 接口中包含了一个名为 admin_Login 的方法，其签名与你期望的 SQL 查询相匹配。例如：

1package com.example.mapper;
2
3import Model.AdminModel;
4import org.apache.ibatis.annotations.Select;
5
6public interface AdminMapper {
7    @Select("SELECT * FROM administrator WHERE adminName = #{adminName} AND adminPwd = #{adminPwd}")
8    AdminModel admin_Login(AdminModel admin);
9}

3. 检查命名空间

确认 AdminMapper.xml 文件中的命名空间与 AdminMapper 接口的全限定类名一致。例如：

1<mapper namespace="com.example.mapper.AdminMapper">

这里前面那一块就是咱们写哪个映射的mapper文件的namespace，困扰我挺久的这个点，但是搞懂了以后会发现很简单，然后最后再加上点和你映射的sql语句名字

4. 检查 MyBatis 配置文件

确认 AdminMapper.xml 文件的路径在 MyBatis 的配置文件中正确注册。例如：

1<?xml version="1.0" encoding="UTF-8" ?>
2<!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN" "http://mybatis.org/dtd/mybatis-3-config.dtd">
3<configuration>
4    <!-- 其他配置... -->
5
6    <mappers>
7        <mapper resource="mapper/AdminMapper.xml"/>
8    </mappers>
9</configuration>

5. 检查调用方式

确认在 Java 代码中正确调用了 AdminMapper 接口中的方法。例如：

1String Admin_Login = "com.example.mapper.AdminMapper.admin_Login";
2AdminModel adminModel1 = sqlSession.selectOne(Admin_Login, adminModel);

实际案例

假设我们在登录验证过程中遇到了上述异常。为了修复这个问题，我们按照上述步骤逐一检查：

1. 检查 AdminMapper.xml 文件:

   • 确认 <mapper> 标签的 namespace 属性与 AdminMapper 接口的全限定类名一致。
   • 确认 <select> 语句的 id 与 AdminMapper 接口中方法名一致。

2. 检查 AdminMapper 接口:

   • 确认 AdminMapper 接口中包含了一个名为 admin_Login 的方法。
   • 确认该方法的签名与你期望的 SQL 查询相匹配。

3. 检查 MyBatis 配置文件:

   • 确认 AdminMapper.xml 文件的路径正确注册。

4. 检查调用方式:

   • 确认在 Java 代码中正确调用了 AdminMapper 接口中的方法。

总结

通过以上步骤，我们可以解决 MyBatis 中因找不到映射语句而引发的 PersistenceException 异常。确保 XML 映射文件、Mapper 接口、MyBatis 配置文件以及调用方式都正确无误是关键。