1. MyBatis框架概述
MyBatis是一款优秀的持久层框架，它消除了几乎所有的JDBC代码和参数的手工设置以及结果集的检索。作为Java开发者最常用的ORM工具之一，MyBatis通过简单的XML或注解配置，将接口和Java对象映射到数据库记录。我在实际项目中使用MyBatis已有五年多时间，见证了这个框架从iBatis到MyBatis3的演进过程。
与Hibernate等全自动ORM框架不同，MyBatis采用半自动化的方式，开发者需要手动编写SQL语句，但结果集到对象的映射工作由框架自动完成。这种设计既保留了SQL的灵活性，又减少了大量重复代码。特别是在处理复杂查询、存储过程调用等场景时，MyBatis展现出明显的优势。
2. MyBatis核心组件解析
2.1 配置文件体系
MyBatis的配置文件主要分为两类：全局配置文件（mybatis-config.xml）和Mapper映射文件。全局配置文件包含数据源、事务管理器、类型处理器等核心配置。我通常会这样组织一个标准配置：
xml复制<configuration>
<properties resource="db.properties"/>
<settings>
<setting name="mapUnderscoreToCamelCase" value="true"/>
<setting name="lazyLoadingEnabled" value="true"/>
</settings>
<typeAliases>
<package name="com.example.model"/>
</typeAliases>
<environments default="development">
<environment id="development">
<transactionManager type="JDBC"/>
<dataSource type="POOLED">
<property name="driver" value="${jdbc.driver}"/>
<property name="url" value="${jdbc.url}"/>
<property name="username" value="${jdbc.username}"/>
<property name="password" value="${jdbc.password}"/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="mapper/UserMapper.xml"/>
</mappers>
</configuration>
注意：在实际项目中，我建议将数据库连接信息单独放在properties文件中，便于不同环境切换。同时，开启mapUnderscoreToCamelCase可以自动将数据库的下划线命名转为Java的驼峰命名。
2.2 SQL映射文件详解
Mapper XML文件是MyBatis的核心，定义了SQL语句与Java方法的映射关系。一个典型的UserMapper.xml可能包含以下内容：
xml复制<mapper namespace="com.example.mapper.UserMapper">
<resultMap id="userResultMap" type="User">
<id property="id" column="id"/>
<result property="username" column="username"/>
<result property="email" column="email"/>
<collection property="roles" ofType="Role" select="selectRolesByUserId" column="id"/>
</resultMap>
<select id="selectUserById" resultMap="userResultMap">
SELECT * FROM users WHERE id = #{id}
</select>
<select id="selectRolesByUserId" resultType="Role">
SELECT r.* FROM roles r
JOIN user_roles ur ON r.id = ur.role_id
WHERE ur.user_id = #{userId}
</select>
</mapper>
这里展示了几个关键特性：
- 结果集映射（ResultMap）：定义了数据库列到Java属性的映射关系
- 参数占位符（#{}）：防止SQL注入的安全写法
- 关联查询（collection）：实现一对多关系的延迟加载
3. MyBatis高级特性实战
3.1 动态SQL构建
MyBatis提供了强大的动态SQL能力，可以根据不同条件动态生成SQL语句。我在处理复杂查询条件时经常使用以下元素：
xml复制<select id="findUsers" resultType="User">
SELECT * FROM users
<where>
<if test="username != null">
AND username LIKE CONCAT('%', #{username}, '%')
</if>
<if test="email != null">
AND email = #{email}
</if>
<choose>
<when test="status == 'active'">
AND is_active = 1
</when>
<when test="status == 'inactive'">
AND is_active = 0
</when>
<otherwise>
AND is_active IS NOT NULL
</otherwise>
</choose>
</where>
ORDER BY
<foreach item="item" index="index" collection="sortBy"
open="" separator="," close="">
${item.field} ${item.direction}
</foreach>
</select>
提示：${}和#{}的区别很重要。${}是直接字符串替换，有SQL注入风险，仅用于确定安全的场景（如排序字段）；#{}是预编译参数，更安全。
3.2 批处理操作优化
处理批量数据时，MyBatis提供了几种优化方案：
- 使用foreach标签批量插入：
xml复制<insert id="batchInsert">
INSERT INTO users(username, email) VALUES
<foreach collection="list" item="user" separator=",">
(#{user.username}, #{user.email})
</foreach>
</insert>
- 开启批处理模式（需要在SqlSessionFactory配置）：
java复制SqlSession session = sqlSessionFactory.openSession(ExecutorType.BATCH);
try {
UserMapper mapper = session.getMapper(UserMapper.class);
for (User user : userList) {
mapper.insert(user);
}
session.commit();
} finally {
session.close();
}
实测表明，批处理模式比单条提交性能提升5-10倍，特别是在处理上万条记录时。
4. MyBatis性能调优经验
4.1 缓存机制深度解析
MyBatis提供两级缓存：
- 一级缓存（本地缓存）：SqlSession级别，默认开启
- 二级缓存：Mapper命名空间级别，需要手动配置
配置二级缓存的正确姿势：
xml复制<cache
eviction="LRU"
flushInterval="60000"
size="512"
readOnly="true"/>
常见问题及解决方案：
- 缓存脏读：在涉及多表关联更新时，建议关闭相关Mapper的缓存
- 缓存雪崩：设置不同的flushInterval
- 分布式环境：集成Redis等分布式缓存
4.2 延迟加载策略
MyBatis支持关联对象的延迟加载，这对提高查询性能很有帮助。配置方式：
xml复制<settings>
<setting name="lazyLoadingEnabled" value="true"/>
<setting name="aggressiveLazyLoading" value="false"/>
</settings>
使用时的注意事项：
- 确保Session在需要加载关联对象时仍然开启
- 避免N+1查询问题，必要时使用join查询
- 对性能敏感的场景，考虑关闭延迟加载
5. 常见问题排查指南
5.1 典型异常处理
-
BindingException：通常是因为Mapper接口与XML文件不匹配
- 检查namespace是否与接口全限定名一致
- 检查方法名是否匹配
-
TooManyResultsException：查询返回多行但期望单结果
- 确认是否应该使用selectOne而不是selectList
- 检查SQL条件是否足够精确
-
事务不生效问题：
- 确认使用的TransactionManager类型
- 检查@Transactional注解是否被正确代理
5.2 SQL注入防范
虽然MyBatis的#{}可以有效防止SQL注入，但在以下场景仍需注意：
- 使用${}进行表名、列名动态替换时
- 使用OGNL表达式处理动态SQL时
- 直接拼接SQL片段时
安全实践建议：
- 对动态表名/列名进行白名单校验
- 避免在前端直接传递排序字段等敏感参数
- 使用MyBatis提供的安全函数（如@Param注解）
6. MyBatis最佳实践总结
经过多个项目的实践，我总结了以下经验法则：
- 项目结构组织：
code复制src/main/java
└── com.example
├── model # 实体类
├── mapper # Mapper接口
└── service # 业务层
src/main/resources
├── mybatis-config.xml
└── mapper
└── UserMapper.xml
- 命名规范：
- Mapper接口：XxxMapper
- XML文件：XxxMapper.xml
- 方法名：selectXxx, insertXxx, updateXxx, deleteXxx
- 性能优化技巧：
- 大批量数据使用批处理模式
- 复杂查询考虑使用存储过程
- 合理配置fetchSize减少内存消耗
- 开发调试建议：
- 开启MyBatis日志（配置logImpl为STDOUT_LOGGING）
- 使用MyBatis Generator自动生成基础代码
- 集成PageHelper插件实现物理分页
在实际项目中，我发现结合Spring Boot使用MyBatis特别高效。以下是一个典型的配置示例：
java复制@Configuration
@MapperScan("com.example.mapper")
public class MyBatisConfig {
@Bean
public SqlSessionFactory sqlSessionFactory(DataSource dataSource) throws Exception {
SqlSessionFactoryBean sessionFactory = new SqlSessionFactoryBean();
sessionFactory.setDataSource(dataSource);
sessionFactory.setTypeAliasesPackage("com.example.model");
// 配置分页插件
Interceptor[] plugins = {new PageInterceptor()};
sessionFactory.setPlugins(plugins);
return sessionFactory.getObject();
}
}
最后分享一个我经常使用的工具类，用于动态切换数据源（在多租户系统中特别有用）：
java复制public class DynamicDataSource extends AbstractRoutingDataSource {
@Override
protected Object determineCurrentLookupKey() {
return DataSourceContextHolder.getDataSourceType();
}
public static class DataSourceContextHolder {
private static final ThreadLocal<String> contextHolder = new ThreadLocal<>();
public static void setDataSourceType(String dataSourceType) {
contextHolder.set(dataSourceType);
}
public static String getDataSourceType() {
return contextHolder.get();
}
public static void clearDataSourceType() {
contextHolder.remove();
}
}
}
这个方案在SAAS系统中经过验证，可以支持每秒上千次的租户数据源切换。关键是要注意及时清理ThreadLocal，避免内存泄漏。