org.xml.sax.SAXParseException 文档根元素 "mapper" 必须匹配 DOCTYPE 根 "configuration"

当发生此错误常规的解决办法如下：

---

mybatis的映射文件 *Mapper.xml文件头错误，我是直接从sql-map-config.xml文件中复制过来的，如下：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN" "http://mybatis.org/dtd/mybatis-3-config.dtd">

很明显，DOCTYPE 是 configuration ，而这个文件中的根节点是 mapper，互相不匹配，所以产生了这个错误；

解决办法

---

修改为以下内容：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">

我这里的解决办法是先找到对应 *Mapper.xml 改掉有问题的标签部分即可。