mybatis的xml文件写在哪 mybatis映射文件xml配置

MyBatis的XML映射文件应放在src/main/resources/mapper/目录下,并与Mapper接口路径保持一致,如cn.example.dao.UserMapper.xml对应UserMapper接口;文件需包含正确的DTD声明和namespace命名空间,SQL标签的id必须与接口方法名一致;在mybatis-config.xml中通过注册,或在Spring Boot的application.yml中配置mybatis.mapper-locations扫描路径;同时建议设置type-aliases-package简化类型定义;确保路径、命名、配置三者匹配即可正确加载。

MyBatis 的 XML 映射文件通常放在项目的 resources 目录下,与对应的 Mapper 接口保持路径一致,以便于管理和加载。

1. XML 文件存放位置

在典型的 Maven 项目结构中,MyBatis 的映射 XML 文件应放在:

src/main/resources/mapper/

或者按照包结构组织,例如:

src/main/resources/cn/example/dao/UserMapper.xml

这样可以和 Java 中的 Mapper 接口(如 cn.example.dao.UserMapper)对应起来,方便通过命名空间识别。

2. XML 映射文件基本结构

一个标准的 MyBatis 映射 XML 文件内容如下:


br> PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">





INSERT INTO users(name, email) VALUES(#{name}, #{email})

3. 配置 MyBatis 加载映射文件

mybatis-config.xml 或 Spring/Spring Boot 配置中,需要指定映射文件的位置。

如果是使用原生 MyBatis 配置,在 mybatis-config.xml 中添加:



如果使用 Spring Boot,推荐在配置文件 application.yml 中指定:

mybatis:
mapper-locations: classpath:mapper/**/*.xml
type-aliases-package: cn.example.entity

这样会自动扫描 resources/mapper 及其子目录下的所有 XML 映射文件。

4. 注意事项

确保以下几点避免常见问题:

  • XML 文件路径和命名空间必须与 Mapper 接口匹配
  • DTD 声明要正确,防止解析错误
  • SQL 标签中的 id 必须与接口方法名一致
  • 使用 IDE 插件(如 MyBatisX)可提升开发效率

基本上就这些。只要路径对、命名对、配置对,MyBatis 就能正确加载 XML 映射文件。不复杂但容易忽略细节。