mybatis的XML映射文件解析出错？ 检查SQL Mapper XML的10个常见问题点

应改为：

• 转义： 写成 youjiankuohaophpcn
• 或使用 CDATA：

3. namespace 不匹配接口

Mapper XML 中的 namespace 必须与对应 Mapper 接口的全限定类名一致，否则无法绑定方法。

例如接口为 com.example.UserMapper，则 XML 中应写：

4. SQL 语句 ID 重复

同一个 namespace 下，id 值必须唯一。重复会导致解析时报错或覆盖已有语句。

检查是否有多个 或其他同名语句。

5. 参数类型未指定或写错

当使用 parameterType 时，类型必须正确，尤其是自定义对象需写全类名。

例如：

若写错类名或拼写错误，会提示类型找不到。

6. resultMap 定义错误或未找到

使用 resultMap 时，若引用的 resultMap 不存在或拼写错误，会抛出异常。

确保：

• resultMap 的 id 正确
• 内部 和 的 property 与实体类字段或 getter/setter 匹配
• 嵌套关联时 type 写对类名

7. 动态 SQL 拼接逻辑错误

如 、、、 嵌套不当，可能导致 SQL 语法错误。

尤其注意：

• 多个 并列时，避免开头出现 AND 或 OR
• 建议用 自动处理前缀

8. 数据库关键字未加转义

如果字段名为数据库保留字（如 order、group、desc），需用反引号或双引号包裹。

MySQL 示例：

PostgreSQL 或 Oracle 可用双引号：

9. XML 文件未被正确加载

即使 XML 写得正确，若未被 MyBatis 扫描到，也会报“找不到映射”错误。

检查：

• Spring 配置中 mapperLocations 是否包含该 XML 路径
• Maven 项目是否将 XML 放在 resources 目录下（非 java 目录）
• 是否存在编译后资源文件未打包的问题

10. DTD 或 XSD 约束不匹配

XML 头部声明的 DTD 如果版本不匹配，可能引发解析异常。

推荐使用官方最新头部：