mybatis报错元素内容必须由格式正确的字符数据或标记组成异常的解决办法

当我们使用mybatis时，有时会出现“元素内容必须由格式正确的字符数据或标记组成”这样的异常，这是由于我们的Mapper.xml或者配置文件中出现了不规范的语法导致的。

下面是解决这个异常的完整攻略：

1. 检查Mapper.xml文件是否正确

首先，我们需要检查Mapper.xml文件是否书写正确，并且所有的元素和属性是否符合标准的XML语法规范，如：

• 是否有缺少结束标签的情况
• 是否所有的标签都有正确的名字和属性
• 是否所有的属性都拥有正确的值

如果在处理xml文件时发现有以下的情况：

<select id ="findUserById"
  resultType="com.test.User">
    select * from users
    where id=#{id}
</select>

这种情况是因为元素的内容出现了多余的空格造成的。解决方式是把SQL语句修正一下，如下所示：

<select id="findUserById" resultType="com.test.User">
    select * from users
    where id=#{id}
</select>

2. 检查mybatis-config.xml文件是否正确

其次，我们还需要检查mybatis-config.xml文件是否正确。它也必须符合标准的XML语法规范，并且必须包含正确的配置。通常，这种异常是因为mybatis-config.xml文件中出现了不正确的或标签。我们需要仔细检查mybatis-config.xml文件，确保所有的标签都是正确封闭的，并且必须包含正确的属性，如：

<typeAliases>
    <typeAlias type="com.test.User" alias="User"/>
</typeAliases>

<mappers>
    <mapper resource="com/test/UserMapper.xml"/>
</mappers>

需要确认的是，在标签中引用的资源路径是否书写正确。比如，如果我们想引用在com.test包下的UserMapper.xml文件，那么引用的方式应该是<mapper resource="com/test/UserMapper.xml"/>。

3. 验证实体类是否符合标准

最后，我们还需要检查实体类是否符合标准JavaBean的规范。这意味着实体类必须包含标准的getter和setter方法，并且所有属性必须包含相应的变量声明。同时，我们还需要仔细检查JavaBean是否存在写错的情况，例如，将属性的命名方式（驼峰命名法）写错。

在实际开发中，这个异常通常是由于上面的某种情况造成的。当我们检查过所有的可能导致这个异常的情况后，重新执行程序就会解决这个异常问题。

示例一：

在Mapper.xml中发现以下SQL语句：

<delete id="deleteUser" paramterType="integer">
    delete from users where id = $#{id}
</delete>

发现语句中$#{id}这段内容是错误的，应该改为#{id}。修改后的语句如下：

<delete id="deleteUser" paramterType="integer">
    delete from users where id = #{id}
</delete>

示例二：

在mybatis-config.xml文件中标签的resource属性中书写错误的路径：

<mappers>
    <mapper resource="com/test/UserMapper.abc"/>
</mappers>

由于资源文件路径书写错误，会导致mybatis找不到这个Mapper，从而抛出异常。需要把路径修正为com/test/UserMapper.xml。