### 解决
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.Users
Mapper.findAllUsers`[^1]，这表明
MyBatis 找不到对应的
SQL 映射语句。
- 确认 `Users
Mapper.xml` 是否被正确加载到
MyBatis 配置文件中。
```xml
<
mappers>
<
mapper resource="com/example/
mapper/Users
Mapper.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="userResult
Mapper" 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="userResult
Mapper">
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` 和其他相关异常的主要原因及其修复办法。具体操作需依据实际项目的结构调整相应参数和配置。
本文指导如何修复编译期间mapper文件中resultType类型错误，需注意全限定名称规范，并提到了使用<typeAliases>标签为别名的技巧。通过实例说明了定位问题和修改方法。
扫一扫
4757
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
