问题：MyBatis单独使用时如何正确加载映射文件？

Question

在单独使用 MyBatis 时，如何正确加载映射文件是一个常见且关键的问题。很多开发者在配置过程中容易出现映射文件路径配置错误、XML 文件未被正确扫描或命名空间配置不当等问题，导致 SQL 映射无法正常工作。正确的方式是通过配置 MyBatis 的核心配置文件 mybatis-config.xml，在 `` 标签中指定映射文件的位置，可以使用相对路径、绝对路径或接口绑定方式。此外，还需确保映射文件在类路径下或被正确打包到输出目录中。理解这些加载机制，有助于避免“Invalid bound statement (not found)”等常见异常，保障 MyBatis 应用的稳定运行。

Answer 1

一、MyBatis 映射文件加载机制概述

在单独使用 MyBatis 时，如何正确加载映射文件是一个常见且关键的问题。很多开发者在配置过程中容易出现映射文件路径配置错误、XML 文件未被正确扫描或命名空间配置不当等问题，导致 SQL 映射无法正常工作。理解 MyBatis 的映射加载机制，是避免“Invalid bound statement (not found)”等常见异常的关键。

二、MyBatis 核心配置文件中的映射加载方式

MyBatis 提供了三种主要方式在 mybatis-config.xml 中加载映射文件：

1. 相对路径加载：使用相对于类路径的路径加载映射文件。
2. 绝对路径加载：使用类全限定名路径加载映射文件。
3. 接口绑定方式：通过绑定接口与 XML 文件，实现映射绑定。

以下是配置示例：

<mappers>
    <mapper resource="mapper/UserMapper.xml"/>
    <mapper url="file:///path/to/OrderMapper.xml"/>
    <mapper class="com.example.mapper.ProductMapper"/>
</mappers>

三、映射文件路径配置的常见问题及解决方案

问题类型	常见表现	解决方案
路径错误	报错：Resource not found	检查 resource 属性路径是否正确，确保文件在类路径下
XML 未扫描	报错：Invalid bound statement (not found)	确保 XML 文件被 Maven 或 Gradle 正确打包到 target/classes 目录下
命名空间冲突	SQL 语句未被正确调用	确认 XML 文件中 namespace 与 Mapper 接口的全限定名一致

四、MyBatis 映射加载机制流程图

graph TD
    A[mybatis-config.xml] --> B{加载方式}
    B -->|resource| C[类路径加载]
    B -->|url| D[绝对路径加载]
    B -->|class| E[接口绑定加载]
    C --> F[检查路径是否存在]
    D --> G[检查URL是否可访问]
    E --> H[绑定接口与XML]
    F & G & H --> I[加载成功/失败处理]

五、构建工具配置与映射文件打包

在使用 Maven 或 Gradle 构建项目时，需确保映射文件被正确打包到 target/classes 目录中。以下是 Maven 的标准配置：

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

该配置确保 Java 源码目录下的 XML 文件也能被正确识别并打包。