mybatis报错:Error parsing SQL Mapper Configuration. Cause: org.apache.ibatis.builder.BuilderException:

本文指导如何修复编译期间mapper文件中resultType类型错误,需注意全限定名称规范,并提到了使用<typeAliases>标签为别名的技巧。通过实例说明了定位问题和修改方法。

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

这个错误导致你编译过程中,无法正常扫描mapper。
在这里插入图片描述

如下图,红色箭头表示resultType返回的类型,但是这里必须填写返回类型的全限定名称,不然就会出现上述报错。

在这里插入图片描述
文件结构
在这里插入图片描述

将resultType改成全限定名称后,也就是入上图 com.bobo.pojo.Customer后就可以了。(如果还是报错就需要在查看该mapper文件中也就是上图CustomerDao.xml中是否还有其他的错误)
另外值得一提的是,如果resultType你一定要写成 Customer的话,那么就需要用到< typeAliases>这个标签来为该全限定名称起一个别名,具体操作如下

 type:自定义类型的全限定名称
 alias:别名(短小,容易记忆的)
  定义完之后,resultType就可以直接使用别名

< typeAliases>  
    <typeAlias type="com.bobo.
pojo.Customer" alias="Customer"/>
    
< /typeAliases>
### 解决 MyBatis 中 `PersistenceException` 和 `BuilderException` 的方法 当遇到 `org.apache.ibatis.exceptions.PersistenceException` 或者 `BuilderException` 报错时,通常是因为 MyBatis 配置文件或者 Mapper XML 文件存在问题。以下是可能的原因以及解决方案: #### 1. **Mapped Statements Collection 不包含指定的 Value** 如果报错信息显示 `Mapped Statements collection does not contain value for mapper.UsersMapper.findAllUsers`[^1],这表明 MyBatis 找不到对应的 SQL 映射语句。 - 确认 `UsersMapper.xml` 是否被正确加载到 MyBatis 配置文件中。 ```xml <mappers> <mapper resource="com/example/mapper/UsersMapper.xml"/> </mappers> ``` - 检查 `id` 属性是否匹配 Java 接口中的方法名称。例如,在接口中有如下定义: ```java List<User> findAllUsers(); ``` 则对应 XML 文件应有相同的 `<select>` 定义: ```xml <select id="findAllUsers" resultType="User"> SELECT * FROM users; </select> ``` #### 2. **XML 文件语法错误** 如果存在 `SAXParseException`,通常是由于 XML 文件不符合标准格式引起的。常见的问题是编码设置不一致或标签未闭合。 - 确保 XML 声明部分指定了正确的编码方式: ```xml <?xml version="1.0" encoding="UTF-8" ?> ``` - 如果出现 UTF-8 编码无效序列问题,则可能是某些字符无法解析为合法的 UTF-8 字符集。可以尝试重新保存文件并确保其编码为 UTF-8。 #### 3. **ResultMap 和 Association 配置不当** 对于复杂查询涉及多表关联的情况,`resultMap` 和 `association` 是常用配置项。但如果这些配置有问题也会引发异常。 - 下面是一个典型的 resultMap 使用示例[^3]: ```xml <resultMap id="userResultMapper" type="User"> <id property="userId" column="user_id"/> <result property="userName" column="user_name"/> <!-- 关联部门 --> <association property="department" javaType="Department"> <id property="deptId" column="dept_id"/> <result property="deptName" column="dept_name"/> </association> </resultMap> <select id="findUserWithDeptById" parameterType="int" resultMap="userResultMapper"> SELECT u.user_id, u.user_name, d.dept_id, d.dept_name FROM user u LEFT JOIN department d ON u.dept_id = d.dept_id WHERE u.user_id = #{userId} </select> ``` - 上述例子展示了如何通过 `association` 将两个对象绑定在一起。注意 `property` 和数据库字段之间的映射关系要保持一致性。 #### 4. **Entity 类型别名缺失** 有时会因为类型别名未注册而导致找不到相应的 Entity 类型。 - 可以在全局配置文件中添加 typeAliases 来简化类路径书写[^4]: ```xml <typeAliases> <typeAlias alias="User" type="com.example.entity.User"/> <typeAlias alias="Department" type="com.example.entity.Department"/> </typeAliases> ``` - 或者直接在 resultMap/parameterType 中使用全限定名代替缩写形式。 --- ### 总结 上述分析涵盖了可能导致 `PersistenceException` 和其他相关异常的主要原因及其修复办法。具体操作需依据实际项目的结构调整相应参数和配置。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值