mybatis的XML映射文件解析出错？ 检查SQL Mapper XML的10个常见问题点
答案：排查MyBatis XML解析错误需检查10个要点：1. 标签未闭合会导致解析失败；2. 特殊字符如&未转义或未用CDATA包裹；3. namespace与Mapper接口全限定名不一致；4. SQL id在同namespace下重复；5. parameterType类名错误或拼写不当；6. resultMap定义错误或引用不存在；7. 动态SQL逻辑问题，如if标签导致AND开头；8. 数据库关键字未用反引号或双引号转义；9. XML文件未被正确加载至resources目录；10. DTD声明版本不匹配或网络不可达。逐项核对可解决多数问题。
MyBatis 的 XML 映射文件在实际开发中非常常用，但一旦写法不当，容易导致
解析失败或运行时异常。遇到“XML映射文件解析出错”时，可以从以下 10 个常见问题点逐一排查。
1. 标签未正确闭合
XML 要求所有标签必须闭合，尤其是 、
常见错误示例：
缺少了正确的闭合符号 > 或漏写结束标签。
2. 特殊字符未转义
SQL 中的 、>、& 等符号在 XML 中有特殊含义，必须进行转义或使用 CDATA 包裹。
错误写法：
AND create_time应改为：
- 转义： 写成 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 拼接逻辑错误
如
尤其注意：
- 多个
并列时，避免开头出现 AND 或 OR - 建议用
自动处理前缀
8. 数据库关键字未加转义
如果字段名为数据库保留字（如 order、group、desc），需用反引号或双引号包裹。
MySQL 示例：
`order` = #{order}PostgreSQL 或 Oracle 可用双引号：
"ORDER" = #{order}9. XML 文件未被正确加载
即使 XML 写得正确，若未被 MyBatis 扫描到，也会报“找不到映射”错误。
检查：
- Spring 配置中 mapperLocations 是否包含该 XML 路径
- Maven 项目是否将 XML 放在 resources 目录下（非 java 目录）
- 是否存在编译后资源文件未打包的问题
10. DTD 或 XSD 约束不匹配
XML 头部声明的 DTD 如果版本不匹配，可能引发解析异常。
推荐使用官方最新头部：
确保网络可访问或本地缓存正确。
基本上就这些。逐项检查后，多数 XML 解析问题都能定位解决。关键是细心和规范写法。不复杂但容易忽略。
