1. MyBatis面试翻车实录那些年我们踩过的坑去年面某大厂时面试官突然扔出一连串MyBatis问题从基础配置到源码设计再到缓存机制和动态SQL问得我措手不及。回家后我整理了这份血泪清单覆盖了90%高频考点和实际开发中的典型问题。如果你不想在面试时被吊打建议认真看完这些实战经验。重要提示本文所有案例均基于MyBatis 3.5.10 Spring Boot 2.7环境验证不同版本可能存在差异1.1 为什么一级缓存会导致事务内查询不到最新数据上周我们线上就出现过这个问题在Transactional方法内先更新数据再查询结果返回的却是旧数据。根本原因在于MyBatis的一级缓存SqlSession级别默认开启且不受事务隔离级别控制。解决方案有三种在mapper方法上添加Options(flushCachetrue)直接调用sqlSession.clearCache()最彻底的方案是配置localCacheScopeSTATEMENT// 典型错误示例 Transactional public void updateAndQuery(Long id) { userMapper.updateStatus(id, 0); // 更新状态 User user userMapper.selectById(id); // 这里拿到的可能是缓存旧数据 }1.2 动态SQL避坑指南1.2.1 XML中特殊符号转义最近在金融项目里处理金额比较时就踩过这个坑!-- 错误写法 -- if testamount 1000.../if !-- 正确写法 -- if testamount lt; 1000.../if建议安装MyBatisX插件它会自动提示XML中的语法问题。其他需要转义的符号包括 () () () () ()1.2.2 动态传参最佳实践当需要传入List 时新手常犯的错误!-- 错误示范 -- select idgetByIds resultTypeUser SELECT * FROM user WHERE id IN foreach collectionlist itemid open( separator, close) #{id} /foreach /select问题在于参数名应该与Param注解一致ListUser getByIds(Param(idList) ListLong ids);!-- 正确写法 -- foreach collectionidList itemid ...1.3 MyBatis Plus实战技巧1.3.1 主键自增重置方案在测试环境经常需要重置自增ID可以通过以下SQL实现ALTER TABLE your_table AUTO_INCREMENT1;如果使用MyBatis Plus的IdType.AUTO需要注意实体类标注TableId(type IdType.AUTO)数据库字段必须设置AUTO_INCREMENT执行truncate table会比delete更彻底1.3.2 从MyBatis迁移到MyBatis Plus我们项目从3.5.3升级到3.7时的主要改动点移除所有手动编写的CRUD XML修改Mapper接口继承BaseMapper调整分页插件配置新版使用MybatisPlusInterceptor注意Version乐观锁注解的变化// 旧版配置 Bean public PaginationInterceptor paginationInterceptor() { return new PaginationInterceptor(); } // 新版配置 Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor new MybatisPlusInterceptor(); interceptor.addInnerInterceptor(new PaginationInnerInterceptor()); return interceptor; }2. 源码级深度解析2.1 执行流程核心链路通过打断点跟踪我梳理出最关键的七个步骤SqlSessionFactoryBuilder解析XML构建ConfigurationMapperProxy动态代理生成Mapper实例MappedStatement缓存SQL指令模板Executor处理缓存和事务StatementHandler构建PreparedStatementParameterHandler处理参数映射ResultSetHandler转换结果集其中最容易出问题的环节是参数处理特别是当使用Map传参时MapString, Object params new HashMap(); params.put(name, 张三); params.put(age, 25); userMapper.selectByMap(params); // 这里Map的key必须与XML中的#{key}严格匹配2.2 插件开发实战去年我们项目需要做数据权限控制通过自定义插件实现Intercepts({ Signature(type Executor.class, methodquery, args{MappedStatement.class, Object.class, RowBounds.class, ResultHandler.class}) }) public class DataPermissionInterceptor implements Interceptor { Override public Object intercept(Invocation invocation) throws Throwable { // 1. 获取原始SQL BoundSql boundSql ((MappedStatement)invocation.getArgs()[0]) .getBoundSql(invocation.getArgs()[1]); // 2. 拼接权限条件 String newSql boundSql.getSql() AND dept_id getCurrentDeptId(); // 3. 重置SQL resetSql(invocation, newSql); return invocation.proceed(); } }关键点通过Intercepts声明拦截目标使用MetaObject修改final字段注意线程安全问题3. 性能优化方案3.1 二级缓存正确打开方式我们电商项目曾因不当使用二级缓存导致库存超卖!-- 危险配置 -- cache evictionLRU size1024/改进方案对实时性要求高的数据如库存关闭二级缓存配置blockingtrue避免缓存击穿实现Cache接口接入Rediscache typecom.company.MyRedisCache property nameexpireTime value3600/ /cache3.2 批量操作性能对比测试10万条数据插入方式耗时(ms)内存消耗(MB)单条循环插入285001200BatchExecutor3200350拼接VALUES批量插入800150推荐写法// 方式1使用BatchExecutor Options(useGeneratedKeys true, keyProperty id) Insert(scriptINSERT INTO user(name,age) VALUES foreach collectionlist itemitem separator, (#{item.name},#{item.age})/foreach/script) void batchInsert(Param(list) ListUser users); // 方式2复用PreparedStatement 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(); }4. 经典面试题剖析4.1 #{}和${}的区别这道题十个候选人九个答不全特性#{}${}预处理是PreparedStatement否直接拼接SQL安全防护防SQL注入有注入风险类型转换自动需要手动处理适用场景参数值动态表名/列名实际项目中我们严格限制${}的使用必须经过安全校验// 安全使用动态表名示例 public ListUser queryByTable(String tableName) { if(!tableName.matches([a-zA-Z_0-9])) { throw new IllegalArgumentException(Invalid table name); } return userMapper.queryFromTable(tableName); }4.2 与Hibernate的核心差异去年做技术选型时我们做的对比维度MyBatisHibernateORM程度半自动需写SQL全自动性能更优直接控制SQL需要优化缓存学习曲线平缓陡峭适用场景复杂查询/性能敏感快速开发/简单CRUD动态SQLXML/注解灵活Criteria API较复杂特别在报表类系统中我们坚持使用MyBatis复杂SQL可调优避免N1查询问题精准控制结果集5. 开发工具链推荐5.1 IDEA高效插件MyBatisX必备XML与接口方法跳转SQL语法检查代码生成MyBatis Log Plugin控制台SQL转可执行语句参数自动填充耗时统计Arthas线上诊断watch org.apache.ibatis.binding.MapperProxy invoke跟踪Mapper方法调用5.2 代码生成技巧我们团队定制的生成模板!-- generatorConfig.xml片段 -- table tableNameuser domainObjectNameUser property nameuseActualColumnNames valuefalse/ generatedKey columnid sqlStatementSELECT LAST_INSERT_ID()/ columnOverride columncreate_time propertycreateTime javaTypejava.time.LocalDateTime/ /table关键优化点使用Java8日期类型统一命名风格驼峰式自动生成ResultMap生成Swagger注解6. 复杂场景解决方案6.1 多数据源事务管理在微服务拆分过渡期我们这样处理跨库事务Configuration MapperScan(basePackages com.dao.db1, sqlSessionTemplateRef db1SqlSessionTemplate) public class Db1Config { Bean ConfigurationProperties(prefix spring.datasource.db1) public DataSource db1DataSource() { return DataSourceBuilder.create().build(); } Bean public PlatformTransactionManager db1TxManager(Qualifier(db1DataSource) DataSource dataSource) { return new DataSourceTransactionManager(dataSource); } } // 使用示例 Transactional(transactionManager db1TxManager) public void crossDbOperation() { db1Mapper.insert(...); db2Mapper.update(...); // 这里会抛出异常 }6.2 分库分表实践订单表按月分表方案public class OrderShardingStrategy implements TableShardingStrategy { Override public String determineTableName(String logicTable, Object params) { OrderQuery query (OrderQuery)params; return order_ query.getCreateTime().format(DateTimeFormatter.ofPattern(yyyyMM)); } } // 配置 ShardingTableConfig config new ShardingTableConfig(); config.setLogicTable(order); config.setActualDataNodes(db.order_${202301..202312}); config.setTableShardingStrategy(new OrderShardingStrategy());7. 升级迁移注意事项从3.5升级到3.7的兼容性问题日志实现变化移除对log4j1.x的直接支持新增JdbcType.TIME_WITH_TIMEZONE处理Param注解变为必须当参数名与占位符不一致时动态SQL的AND/OR前缀处理更严格建议升级步骤先升级到3.5.13过渡版本运行测试用例检查日志输出重点检查动态SQL片段验证分页插件行为!-- 依赖管理示例 -- dependency groupIdorg.mybatis/groupId artifactIdmybatis/artifactId version3.7.0/version /dependency dependency groupIdorg.mybatis.spring.boot/groupId artifactIdmybatis-spring-boot-starter/artifactId version3.0.3/version /dependency8. 生产环境血泪教训8.1 连接泄露排查某次大促前压测发现的典型问题// 错误示例 public ListUser queryUsers() { SqlSession session sqlSessionFactory.openSession(); return session.selectList(queryUsers); // 忘记关闭session! }排查工具Druid的removeAbandoned配置使用jstack查看线程栈添加连接生命周期监控8.2 超大结果集处理导出百万数据时的优化方案// 流式查询示例 Select(SELECT * FROM large_table) Options(resultSetType ResultSetType.FORWARD_ONLY, fetchSize Integer.MIN_VALUE) void streamQuery(ResultHandlerUser handler); // 使用方式 userMapper.streamQuery(resultContext - { User user resultContext.getResultObject(); // 逐行处理 if(resultContext.getResultCount() % 10000 0) { System.out.println(已处理 resultContext.getResultCount()); } });关键参数fetchSizeInteger.MIN_VALUE 启用流式ResultSetType.FORWARD_ONLY 只进游标配合ResultHandler逐行消费9. 架构设计思想9.1 插件体系设计MyBatis插件本质是基于责任链模式// 简化后的调用链 public class Plugin implements InvocationHandler { private Object target; private Interceptor interceptor; public Object invoke(Object proxy, Method method, Object[] args) throws Throwable { if(!interceptor.getClass().isAnnotationPresent(Intercepts.class)) { return method.invoke(target, args); } return interceptor.intercept(new Invocation(target, method, args)); } }开发插件时的黄金法则不要修改原始参数谨慎处理ResultSet避免递归调用9.2 缓存设计哲学一级缓存设计精妙之处与SqlSession生命周期绑定执行update操作自动清除可配置为STATEMENT级别二级缓存注意事项事务提交后才生效需要序列化实体类避免多表关联查询!-- 安全的缓存配置示例 -- cache typeorg.mybatis.caches.ehcache.EhcacheCache property nametimeToIdleSeconds value1800/ property namememoryStoreEvictionPolicy valueLRU/ /cache10. 前沿生态整合10.1 与Spring Boot深度集成自动配置的核心逻辑通过AutoConfigureAfter确定初始化顺序根据spring.datasource.*创建DataSource扫描Mapper接口注册MapperFactoryBean配置MyBatisProperties中的各项参数自定义集成方案Configuration public class MyBatisCustomConfig { Bean public ConfigurationCustomizer configurationCustomizer() { return configuration - { configuration.setMapUnderscoreToCamelCase(true); configuration.setDefaultFetchSize(100); configuration.setLazyLoadingEnabled(true); }; } }10.2 云原生适配在K8s环境中的最佳实践使用HikariCP替代Druid更轻量配置健康检查端点management: endpoints: web: exposure: include: health,info health: db: enabled: true动态数据源切换方案Around(annotation(ds)) public Object switchDataSource(ProceedingJoinPoint pjp, DS ds) throws Throwable { String dsKey DynamicDataSourceHolder.getDataSourceKey(); try { DynamicDataSourceHolder.setDataSourceKey(ds.value()); return pjp.proceed(); } finally { DynamicDataSourceHolder.setDataSourceKey(dsKey); } }