Spring Boot + MyBatis 启动报错：不允许有匹配 “[xX][mM][lL]“ 的处理指令目标

问题描述：

今天启动 Spring Boot 项目时，控制台报错如下：

org.springframework.beans.factory.UnsatisfiedDependencyException: Error creating bean with name 'activityController': Unsatisfied dependency expressed through field 'activityService': Error creating bean with name 'activityService': Unsatisfied dependency expressed through field 'activityMapper': Error creating bean with name 'activityMapper' defined in file [E:\idea_code\partner_match\target\classes\com\jade\partnermatch\mapper\ActivityMapper.class]: Unsatisfied dependency expressed through bean property 'sqlSessionFactory': Error creating bean with name 'sqlSessionFactory' defined in class path resource [org/mybatis/spring/boot/autoconfigure/MybatisAutoConfiguration.class]: Failed to instantiate [org.apache.ibatis.session.SqlSessionFactory]: Factory method 'sqlSessionFactory' threw exception with message: Failed to parse mapping resource: 'file [E:\idea_code\partner_match\target\classes\mapper\JoinRequestMapper.xml]'

完整错误信息显示 MyBatis 在解析 ActivityMapper.xml 文件时失败。

错误原因:

经过排查，发现是 XML 文件第一行之前存在空行 导致的。

MyBatis 在解析 XML 映射文件时，要求文件的第一行必须是 XML 声明：

<?xml version="1.0" encoding="UTF-8"?>

如果这行之前有任何字符（包括空格、空行、BOM头），XML 解析器就会报错。

解决方案：

1. 打开 ActivityMapper.xml 文件

2. 检查第一行 <?xml version="1.0" encoding="UTF-8"?> 之前是否有空行或空格

3. 删除所有空行，确保 XML 声明在文件的第一行

4. 重新编译项目（mvn clean compile）

5. 重启应用

其他可能原因

如果删除空行后问题仍然存在，可以检查：

• 文件编码：确保使用 UTF-8 无 BOM 格式保存

• XML 声明格式：确认语法正确，没有拼写错误

• 标签闭合：检查 XML 标签是否正确闭合

总结

这个小问题浪费了我不少时间，记录一下提醒自己：

XML 文件的第一行必须是 <?xml version="1.0" encoding="UTF-8"?>，前面不能有任何内容，包括空行！