目录
前言：为什么我们需要关注 MyBatis 与 Spring 的整合？
在现代 Java 企业级开发中，我们经常面临这样一个挑战：如何在保持对 SQL 语句细粒度控制的同时，享受框架带来的便利性？Hibernate 等全自动 ORM 框架虽然强大，但在面对复杂查询、遗留数据库重构或性能优化时，往往会让我们感到束手无策。
这时，MyBatis 就成为了我们的首选方案。它消除了几乎所有的 JDBC 代码以及手动设置参数和获取结果集的繁琐工作。然而，单独使用 MyBatis 仍然需要我们处理繁琐的配置和事务管理。
在这篇文章中，我们将深入探讨如何将 MyBatis 与 Spring 生态系统完美结合。我们将学习如何利用 Spring 的依赖注入（DI）和面向切面编程（AOP）特性，让 MyBatis 的开发体验更上一层楼。无论你是对 SQL 有极致追求的性能控，还是需要维护复杂业务逻辑的后端工程师，这篇指南都将为你提供从入门到精进的实用知识。
什么是 MyBatis？
在开始整合之前，让我们先快速回顾一下 MyBatis 的核心价值。MyBatis 是一款优秀的持久层框架，它支持自定义 SQL、存储过程以及高级映射。与 Hibernate 这种“全自动化”的 ORM 框架不同，MyBatis 并非试图将 Java 对象完全隐藏在数据库之后，而是致力于成为连接 Java 对象与数据库SQL世界的桥梁。
为什么选择 MyBatis 而不是 Hibernate？
你可能会问：“我应该在什么时候选择 MyBatis？”这是一个非常经典的问题。
- SQL 控制权：如果你的业务逻辑非常复杂，需要编写高度优化的 SQL 查询，或者你需要利用数据库特定的特性（如窗口函数、递归查询），MyBatis 允许你直接编写原生的 SQL，而不会被 Hibernate 的 HQL 限制住手脚。
- 性能优化：在处理大批量数据插入或更新时，MyBatis 的批量操作功能往往比 Hibernate 更容易调优，因为它没有脏检查和持久化上下文的开销。
- 灵活性：对于字段映射不规范的旧系统，MyBatis 可以通过 ResultMap 灵活地映射表结构到 Java 对象，而不需要强制修改数据库结构以适应 ORM 规则。
核心概念：Mapper 接口的魔法
在整合 Spring 之前，我们需要理解 MyBatis 最核心的组件：Mapper 接口。
1. 基于注解的 Mapper
最直观的方式是使用注解。我们可以在接口中直接定义 SQL，这种方式对于简单的 CRUD（增删改查）操作非常方便。
import org.apache.ibatis.annotations.Select;
import org.apache.ibatis.annotations.Param;
public interface UserMapper {
/**
* 根据ID查询用户
* 这里的 @Select 注解直接包含了 SQL 语句
* #{id} 是一个占位符，MyBatis 会自动将其替换为方法参数中的 id 值
*/
@Select("SELECT id, name, email FROM users WHERE id = #{id}")
User findById(int id);
/**
* 根据名称模糊查询用户列表
* 这里演示了如何传递字符串参数
* CONCAT 函数用于 SQL 中的字符串拼接，实现模糊搜索
*/
@Select("SELECT * FROM users WHERE name LIKE CONCAT(‘%‘, #{name}, ‘%‘)")
List findByName(String name);
}
实用见解：虽然注解很方便，但当代码中的 SQL 变得冗长时，Java 类的可读性会下降，且字符串拼接容易出错。这就引出了我们的第二种方式。
2. 基于 XML 的 Mapper
对于复杂的系统，我们通常建议将 SQL 从 Java 代码中剥离出来，放在 XML 文件中。这不仅让代码更整洁，还方便 DBA（数据库管理员）参与 SQL 的审查和优化。
UserMapper.xml
SELECT id, name, email
FROM users
WHERE id = #{id}
SELECT u.id, u.name, o.id as order_id, o.amount
FROM users u
LEFT JOIN orders o ON u.id = o.user_id
WHERE u.id = #{userId}
深入整合：MyBatis 与 Spring 的无缝对接
现在，让我们进入本文的核心部分：如何让 Spring 管理 MyBatis。
1. 利用 Spring Boot Starter 自动化配置
在过去，我们需要在 Spring 的 XML 配置文件中定义 INLINECODEc14f2cc5 和 INLINECODE91282f83，这非常繁琐。现在，我们只需要引入一个 Starter 依赖。
Maven 依赖
org.mybatis.spring.boot
mybatis-spring-boot-starter
3.0.3
这个依赖做了很多“看不见”的工作：
- 它自动检测classpath中的
DataSource。 - 它创建并注册一个
SqlSessionFactory实例。 - 它扫描并注册 Mapper 接口，使其成为 Spring Bean。
2. Mapper 扫描与注册
为了让 Spring 知道去哪里寻找我们的 Mapper 接口，我们有两个选择。
方案 A：使用 @MapperScan 注解（推荐）
这是我们最常用的方式。在配置类或启动类上添加注解：
import org.mybatis.spring.annotation.MapperScan;
import org.springframework.boot.autoconfigure.SpringBootApplication;
@SpringBootApplication
// 指定 Mapper 接口所在的包名，Spring 会自动将它们注册为 Bean
@MapperScan("com.example.demo.mapper")
public class ApplicationConfig {
// 应用程序入口
}
方案 B：单独使用 @Mapper 注解
如果你不想扫描整个包，也可以在每个 Mapper 接口上直接添加 @Mapper 注解。但当你有几十个 Mapper 时，这种方式会显得很累赘。
3. 事务管理的艺术
数据库操作最怕的就是数据不一致。Spring 的声明式事务管理是解决这一问题的利器。
关键点：在 MyBatis 中，INLINECODE02f3708e（相当于 JDBC 的 Connection）是线程不安全的。Spring 通过利用 ThreadLocal 机制，将 INLINECODE6eeacfa6 绑定到当前线程的上下文中，从而保证了在整个事务过程中使用的是同一个数据库连接。
实战示例：Service 层的事务控制
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;
@Service
public class UserService {
private final UserMapper userMapper;
private final AuditLogMapper auditLogMapper;
// 构造器注入，这是 Spring 推荐的注入方式
public UserService(UserMapper userMapper, AuditLogMapper auditLogMapper) {
this.userMapper = userMapper;
this.auditLogMapper = auditLogMapper;
}
/**
* 转账操作：这是一个典型的事务场景。
* 我们需要确保两个更新操作要么同时成功，要么同时失败。
*
* @Transactional 注解告诉 Spring，这个方法内的所有数据库操作
* 都应该在同一个事务中执行。
*/
@Transactional(rollbackFor = Exception.class)
public void transferMoney(int fromUserId, int toUserId, double amount) {
// 1. 扣除转出者金额
userMapper.deductBalance(fromUserId, amount);
// 模拟一个异常：如果这里发生异常，上面的操作将回滚，数据库保持一致
if (amount > 10000) {
throw new RuntimeException("单笔转账金额不能超过 10000");
}
// 2. 增加转入者金额
userMapper.addBalance(toUserId, amount);
// 3. 记录操作日志
auditLogMapper.insertLog("Transfer from " + fromUserId + " to " + toUserId);
}
}
常见错误与解决方案：
- 注意：INLINECODEbbc31234 默认只对 INLINECODEfeadc176 和 INLINECODE54de592c 进行回滚。如果你的代码中捕获了异常但没有重新抛出，事务将不会回滚。上面的代码中，我们显式指定了 INLINECODE389a0c87，以确保任何异常都能触发回滚。
进阶配置与性能优化
作为开发者，我们不仅要让代码“跑起来”，还要让它“跑得快”。
1. 配置文件优化
在 INLINECODE420d62ca 或 INLINECODE0da37c03 中，MyBatis 提供了丰富的配置选项。
# 驼峰命名自动映射
# 数据库字段 user_name 自动映射到 Java 属性 userName
mybatis.configuration.map-underscore-to-camel-case=true
# 开启二级缓存
# 全局开启二级缓存，但通常我们建议在具体的 Mapper XML 中开启，以便精细控制
mybatis.configuration.cache-enabled=true
# 打印 SQL 日志（开发环境必备）
# 这能让你在控制台看到实际执行的 SQL，这对于调试非常有帮助
logging.level.com.example.demo.mapper=DEBUG
2. 动态 SQL 的威力
MyBatis 最强大的功能之一是动态 SQL。你是否曾经写过类似这样的代码：if (name != null) sql += " and name = " + name;？MyBatis 使用 XML 标签优雅地解决了这个问题。
场景：多条件搜索用户。
SELECT * FROM users
AND name LIKE #{name}
AND email = #{email}
AND age >= #{minAge}
在这个例子中，即使所有参数都为空，生成的 SQL 也是合法的（WHERE 会被自动移除）。这大大减少了我们拼接字符串时的痛苦。
3. 批量操作优化
当需要插入一万条数据时，如果你在循环中调用 insert 方法，性能会非常差，因为每次都要开启新的事务和网络连接。
最佳实践：使用 SqlSessionFactory 开启批量模式（Batch Executor）。
@Service
public class BatchUserService {
private final UserMapper userMapper;
private final SqlSessionFactory sqlSessionFactory;
public BatchUserService(UserMapper userMapper, SqlSessionFactory sqlSessionFactory) {
this.userMapper = userMapper;
this.sqlSessionFactory = sqlSessionFactory;
}
public void batchInsert(List users) {
// 开启一个新的 Session
try (SqlSession sqlSession = sqlSessionFactory.openSession(ExecutorType.BATCH)) {
// 在批量 Session 中获取 Mapper
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
for (User user : users) {
mapper.insert(user);
// 注意：这里不需要每次都提交，Session 会缓存 SQL
}
// 统一提交并刷新
sqlSession.commit();
sqlSession.flushStatements();
}
}
}
这种方式的性能通常是普通循环插入的十几倍甚至几十倍。
总结与后续步骤
通过这篇文章，我们不仅了解了 MyBatis 是什么，更重要的是，我们掌握了如何将它与 Spring 框架高效地整合在一起。我们探讨了从基础的 Mapper 接口定义，到复杂的事务管理和性能优化策略。
让我们回顾一下几个关键点：
- Mapper 接口是你的命令中心，你可以选择注解的便捷，也可以选择 XML 的强大。
- Spring Boot Starter消除了 90% 的样板代码配置。
- 事务管理是保证数据完整性的基石，请务必正确使用
@Transactional。 - 动态 SQL 和 批量操作是处理复杂业务和高性能场景的必备技能。
接下来你应该做什么？
我建议你尝试在本地搭建一个简单的 Spring Boot 项目，配置好 MyBatis，并试着编写一个包含“一对多”关系的查询（例如：用户和订单）。然后，尝试开启 MyBatis 的日志，观察 SQL 是如何被生成和执行的。
通过实际动手编写代码，你会对这些概念有更深刻的理解。如果你在开发中遇到任何问题，记住：查看生成的 SQL 日志往往是解决问题的关键第一步。