SqlSessionFactory是单例工厂,SqlSession需手动关闭且非线程安全,Mapper接口与XML的namespace和id必须严格一致,ResultMap通过association/collection处理嵌套映射并防N+1。

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 包裹,否则数据库连接不会释放 - 直接用它查关联数据(如一对多)时,需手动指定
resultMapID,不能只靠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 中
的id完全一致 - 参数类型、返回类型要能被 MyBatis 自动匹配(否则报
BindingException)
org.apache.ibatis.binding.BindingException: Invalid bound statement (not found): com.example.mapper.UserMapper.selectUserById
ResultMap 是映射中枢,association 和 collection 决定嵌套结构能否展开
当查用户+地址(一对一)或用户+订单列表(一对多)时,resultType 不够用,必须写 resultMap。注意:
- 一对一用
- 一对多用
- 字段名与属性名不一致时,必须显式写
column和property,别指望驼峰自动转换覆盖所有场景 - 嵌套过深(如主表→子表→孙表)容易触发 N+1 查询,要用
fetchType="eager"或改写为 JOIN 查询
真正卡住人的从来不是“有没有写 resultMap”,而是字段别名没对齐、ofType 写错类名、或者忘记在 SELECT 中把子表字段也 select 出来——这些地方一漏,返回对象里对应属性就是 null,还查不出错。










