mysql MyBatis常用类有哪些_mysql映射关系说明

来源：这里教程网时间：2026-02-28 20:36:43 作者：

SqlSessionFactory

、

SqlSession

、

Mapper

接口和

ResultMap

是 MyBatis 操作 MySQL 时最常打交道的四个核心类/配置项——它们不是“工具类”，而是框架运行时真正承载数据映射逻辑的骨架。

SqlSessionFactory 是工厂，但别手动 new

它负责创建

SqlSession

，通常只在应用启动时构建一次（比如通过

SqlSessionFactoryBuilder.build()

加载

mybatis-config.xml

）。常见错误是每次查询都重建它：

SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(...); // ❌ 错误：重量级对象，不应频繁创建

正确做法是把它作为单例交给 Spring 管理，或用静态变量持有。否则会严重拖慢性能，还可能引发连接池耗尽。

SqlSession 是会话，用完必须 close

它是执行 SQL 的入口，提供

selectOne

、

insert

、

update

、

delete

等方法。关键点在于：

它不是线程安全的，不能共享 必须显式调用
close()
或用 try-with-resources 包裹，否则数据库连接不会释放直接用它查关联数据（如一对多）时，需手动指定
resultMap
ID，不能只靠
resultType
示例：

try (SqlSession session = sqlSessionFactory.openSession()) {User user = session.selectOne("com.example.mapper.UserMapper.selectUserWithOrders", 123);}

Mapper 接口本质是代理，namespace 和 id 必须严丝合缝

你写的接口（如

UserMapper

）本身不实现逻辑，MyBatis 动态生成代理对象来绑定 XML 中的 SQL。这就要求：

namespace
必须等于接口全限定名（如
com.example.mapper.UserMapper
）每个方法名必须与 XML 中
<select id="xxx"></select>
的
id
完全一致参数类型、返回类型要能被 MyBatis 自动匹配（否则报
BindingException
）错一个字母，运行时报错就是：

org.apache.ibatis.binding.BindingException: Invalid bound statement (not found): com.example.mapper.UserMapper.selectUserById

ResultMap 是映射中枢，association 和 collection 决定嵌套结构能否展开

当查用户+地址（一对一）或用户+订单列表（一对多）时，

resultType

不够用，必须写

resultMap

。注意：

一对一用
<association property="address" javatype="Address"></association>
一对多用
<collection property="orders" oftype="Order"></collection>
字段名与属性名不一致时，必须显式写
column
和
property
，别指望驼峰自动转换覆盖所有场景嵌套过深（如主表→子表→孙表）容易触发 N+1 查询，要用
fetchType="eager"
或改写为 JOIN 查询

真正卡住人的从来不是“有没有写 resultMap”，而是字段别名没对齐、