MyBatis XML映射文件以为根元素,需声明对应接口全限定名的namespace;通过、等标签定义SQL,id匹配方法名,#{xxx}安全传参,处理字段映射与关联查询,与实现SQL复用。

MyBatis 的 XML 映射文件(Mapper XML)是用来定义 SQL 语句和结果映射的核心配置,它把 Java 接口方法和数据库操作解耦,让 SQL 更清晰、可维护性更强。
XML 文件基本结构和命名规范
每个 Mapper XML 文件需对应一个接口(如 UserMapper.java),文件名建议与接口同名(UserMapper.xml),并放在相同包路径下(或通过 显式注册)。根元素必须是 ,且必须声明 namespace,值为对应接口的全限定类名:
常用 SQL 标签怎么写
核心标签包括 、、、,每个标签用 id 属性对应接口中的方法名,用 parameterType 指定入参类型(可省略,MyBatis 能自动推断),用 resultType 或 resultMap 指定返回类型:
-
简单查询:
-
带条件插入:
INSERT INTO user(name, age) VALUES(#{name}, #{age}) -
动态更新:用
+避免逗号和 SET 关键字冗余:
UPDATE user
name = #{name},
age = #{age}
WHERE id = #{id}
结果映射(resultMap)怎么配
当列名和属性名不一致,或需要嵌套查询(一对一、一对多)时,要用 。先定义 ID,再用 (主键)、(普通字段)做映射;复杂关系用 (一对一)或 (一对多):
注意:select 属性指向另一个 的 id,实现延迟加载(需开启 lazyLoadingEnabled)。
SQL 片段复用与参数处理
用 标签抽取可复用的 SQL 片段(如公共字段列表),再用 引入;参数占位统一用 #{xxx}(预编译防注入),仅在极少数场景(如 ORDER BY 字段)才用 ${xxx}(字符串拼接,需自行校验):
- 定义片段:
id, name, age, create_time - 引用片段:
- 安全传参:
WHERE status = #{status}✅;ORDER BY ${sortBy}⚠️(确保 sortBy 是白名单值)










