本文将介绍 MyBatis 中的一些常见错误及其解决方法。

一、Mapper.xml 未找到

1. 错误

2. 解决方法

打开 src\main\resources 下的 mybatis-config.xml 文件，增加配置如下：

<mappers>
	<mapper resource="mapper.xml的路径"/>
</mappers>

例如：

<mappers>
	<mapper resource="org/example/dao/UserMapper.xml"/>
</mappers>

二、Mapper.xml 定位错误

1. 错误

2. 解决方法

注意：

使用 resource 来定位 XxxMapper.xml 文件时，不应该写全类名，而应该写路径（以 / 分隔）

将 src\main\resources\mybatis-config.xml 文件中的

<mapper resource="org.example.dao.UserMapper.xml"/>

修改为

<mapper resource="org/example/dao/UserMapper.xml"/>

三、java 文件夹下的 xml 未被打包

1. 错误

且编译后的 target 文件夹中，仅有类，却没有对应的 xml

2. 解决方法

Maven 默认只会导出 resources 文件夹下的配置文件，因此在编译时，放置于 java 文件夹下的 XxxMapper.xml 文件没有被导出。

解决方法是在 pom.xml 中，增加配置如下：

<build>
    <resources>
        <resource>
            <directory>src/main/java</directory>
            <includes>
                <include>**/*.xml</include>
            </includes>
            <filtering>true</filtering>
        </resource>
    </resources>
</build>

修改后，java 文件夹下的 xml 文件被正确导出，且程序也能够正常运行。