1. 项目概述SpringBoot整合Mybatis是Java后端开发中最经典的技术组合之一。作为一个常年混迹在企业级Java开发一线的老码农我几乎在每个新项目启动时都要重新搭建这套环境。虽然现在各种脚手架工具能快速生成项目骨架但真正理解每个配置项的作用和整合原理才能在遇到问题时快速定位和解决。这套组合之所以流行是因为它完美结合了SpringBoot的约定优于配置理念和Mybatis的SQL灵活性。SpringBoot帮我们省去了大量繁琐的XML配置而Mybatis则让我们能够精细控制每一条SQL语句。在实际项目中这种组合既能保证开发效率又能满足复杂业务场景下的SQL优化需求。2. 核心需求解析2.1 为什么选择这个技术组合在企业级应用开发中我们通常需要快速搭建可运行的项目骨架对数据库操作有精细控制能力良好的事务管理支持与现有Spring生态无缝集成SpringBootMybatis正好满足这些需求。相比JPAMybatis给了开发者更多SQL层面的控制权这对需要复杂查询和性能优化的场景特别重要。我在电商系统中处理过大量需要手动优化SQL的案例这时候Mybatis的优势就体现出来了。2.2 典型应用场景这套组合特别适合以下场景需要复杂SQL查询的报表系统对数据库性能敏感的交易系统遗留数据库迁移项目需要兼容已有SQL需要同时使用ORM和原生SQL的混合场景3. 环境准备与基础配置3.1 创建SpringBoot项目推荐使用Spring Initializr创建项目骨架curl https://start.spring.io/starter.zip \ -d dependenciesweb,mybatis \ -d languagejava \ -d typemaven-project \ -d javaVersion17 \ -d artifactIdmybatis-demo \ -o mybatis-demo.zip关键依赖说明spring-boot-starter-web: 提供Web MVC支持mybatis-spring-boot-starter: Mybatis官方提供的SpringBoot集成包数据库驱动: 根据使用的数据库选择如MySQL需要添加mysql-connector-java3.2 数据库配置在application.properties中配置数据源# 数据源配置 spring.datasource.urljdbc:mysql://localhost:3306/demo?useSSLfalseserverTimezoneUTC spring.datasource.usernameroot spring.datasource.password123456 spring.datasource.driver-class-namecom.mysql.cj.jdbc.Driver # Mybatis配置 mybatis.mapper-locationsclasspath:mapper/*.xml mybatis.type-aliases-packagecom.example.demo.entity注意生产环境密码应该加密存储可以使用Jasypt等工具4. Mybatis集成核心实现4.1 实体类与Mapper接口首先定义实体类Data public class User { private Long id; private String name; private Integer age; private String email; }然后创建Mapper接口Mapper public interface UserMapper { Select(SELECT * FROM user WHERE id #{id}) User findById(Long id); Insert(INSERT INTO user(name, age, email) VALUES(#{name}, #{age}, #{email})) Options(useGeneratedKeys true, keyProperty id) int insert(User user); Update(UPDATE user SET name#{name}, age#{age}, email#{email} WHERE id#{id}) int update(User user); Delete(DELETE FROM user WHERE id#{id}) int delete(Long id); }4.2 XML映射文件配置对于复杂SQL推荐使用XML方式!-- src/main/resources/mapper/UserMapper.xml -- mapper namespacecom.example.demo.mapper.UserMapper resultMap idBaseResultMap typeUser id columnid propertyid / result columnname propertyname / result columnage propertyage / result columnemail propertyemail / /resultMap select idselectComplexQuery resultMapBaseResultMap SELECT * FROM user where if testname ! null AND name LIKE CONCAT(%, #{name}, %) /if if testminAge ! null AND age #{minAge} /if /where ORDER BY id DESC /select /mapper4.3 服务层实现典型的服务层代码结构Service RequiredArgsConstructor public class UserService { private final UserMapper userMapper; public User getUserById(Long id) { return userMapper.findById(id); } public ListUser searchUsers(String name, Integer minAge) { return userMapper.selectComplexQuery(name, minAge); } Transactional public void updateUser(User user) { if (userMapper.update(user) 0) { throw new RuntimeException(更新失败); } } }5. 高级特性与优化5.1 分页插件集成Mybatis分页推荐使用PageHelper// 添加依赖 implementation com.github.pagehelper:pagehelper-spring-boot-starter:1.4.6 // 使用示例 public PageInfoUser getUsersByPage(int pageNum, int pageSize) { PageHelper.startPage(pageNum, pageSize); ListUser users userMapper.selectAll(); return new PageInfo(users); }5.2 多数据源配置对于需要连接多个数据库的场景Configuration MapperScan(basePackages com.example.demo.mapper.primary, sqlSessionFactoryRef primarySqlSessionFactory) public class PrimaryDataSourceConfig { Bean ConfigurationProperties(spring.datasource.primary) public DataSource primaryDataSource() { return DataSourceBuilder.create().build(); } Bean public SqlSessionFactory primarySqlSessionFactory(Qualifier(primaryDataSource) DataSource dataSource) throws Exception { SqlSessionFactoryBean sessionFactory new SqlSessionFactoryBean(); sessionFactory.setDataSource(dataSource); sessionFactory.setMapperLocations(new PathMatchingResourcePatternResolver() .getResources(classpath:mapper/primary/*.xml)); return sessionFactory.getObject(); } Bean public DataSourceTransactionManager primaryTransactionManager(Qualifier(primaryDataSource) DataSource dataSource) { return new DataSourceTransactionManager(dataSource); } }5.3 动态数据源路由基于AbstractRoutingDataSource实现public class DynamicDataSource extends AbstractRoutingDataSource { Override protected Object determineCurrentLookupKey() { return DynamicDataSourceContextHolder.getDataSourceKey(); } } // 使用AOP切换数据源 Around(annotation(dataSource)) public Object around(ProceedingJoinPoint point, DataSource dataSource) throws Throwable { DynamicDataSourceContextHolder.setDataSourceKey(dataSource.value()); try { return point.proceed(); } finally { DynamicDataSourceContextHolder.clearDataSourceKey(); } }6. 性能优化实践6.1 SQL执行监控集成p6spy监控真实SQL# application.properties spring.datasource.urljdbc:p6spy:mysql://localhost:3306/demo spring.datasource.driver-class-namecom.p6spy.engine.spy.P6SpyDriver # spy.properties module.logcom.p6spy.engine.logging.P6LogFactory filtertrue excludespring.datasource6.2 二级缓存配置启用Mybatis二级缓存!-- 在mapper.xml中 -- cache evictionLRU flushInterval60000 size512 readOnlytrue/ !-- 配置Redis缓存 -- Bean public Cache mybatisRedisCache() { return new MybatisRedisCache(mybatisCache); }6.3 批量操作优化使用BatchExecutor提升批量操作性能Autowired private SqlSessionFactory sqlSessionFactory; public void batchInsert(ListUser users) { try (SqlSession session sqlSessionFactory.openSession(ExecutorType.BATCH)) { UserMapper mapper session.getMapper(UserMapper.class); for (User user : users) { mapper.insert(user); } session.commit(); } }7. 常见问题排查7.1 映射文件找不到症状Invalid bound statement (not found)解决方案检查mybatis.mapper-locations配置路径是否正确确保XML文件在resources目录下对应路径检查Mapper接口和XML的namespace是否一致7.2 事务不生效可能原因方法不是public异常类型不是RuntimeException同类方法调用this.method()数据源配置不正确7.3 分页插件失效排查步骤检查PageHelper.startPage()是否在查询前调用确认没有在startPage和查询之间执行其他SQL检查是否有多个SqlSessionFactory导致拦截器未生效8. 生产环境最佳实践8.1 安全规范SQL注入防护永远不要拼接SQL使用#{}而不是${}对用户输入进行严格校验敏感数据保护数据库密码加密生产环境关闭SQL日志使用Mybatis的TypeHandler处理加密字段8.2 性能规范查询优化避免SELECT *合理使用索引提示大数据量查询使用流式处理连接池配置spring.datasource.hikari.maximum-pool-size20 spring.datasource.hikari.minimum-idle5 spring.datasource.hikari.idle-timeout300008.3 监控指标关键监控项SQL执行时间慢查询统计连接池使用情况缓存命中率集成Prometheus监控示例Bean public CollectorRegistry mybatisMetrics(DataSource dataSource) { CollectorRegistry registry new CollectorRegistry(); new DataSourceExports(dataSource).register(registry); return registry; }9. 测试策略9.1 单元测试使用Mybatis TestMybatisTest AutoConfigureTestDatabase(replace Replace.NONE) class UserMapperTest { Autowired private UserMapper userMapper; Test void testFindById() { User user userMapper.findById(1L); assertNotNull(user); } }9.2 集成测试SpringBoot Test示例SpringBootTest Transactional class UserServiceTest { Autowired private UserService userService; Test void testUpdateUser() { User user new User(); user.setId(1L); user.setName(newName); assertDoesNotThrow(() - userService.updateUser(user)); } }9.3 性能测试使用JMeter测试建议模拟并发用户逐渐增加监控数据库连接池使用情况关注GC日志和内存变化10. 扩展与演进10.1 与Spring Data JPA混合使用有些场景适合混合使用public interface UserRepository extends JpaRepositoryUser, Long { // JPA方式 ListUser findByName(String name); // Mybatis方式 Query(nativeQuery true, value SELECT * FROM user WHERE age :age) ListUser findByAgeGreaterThan(Param(age) int age); }10.2 迁移到Mybatis-Plus平滑迁移步骤添加Mybatis-Plus依赖逐步替换Mapper接口为BaseMapper保留复杂SQL的XML配置利用LambdaQueryWrapper简化代码10.3 云原生适配Kubernetes部署建议使用ConfigMap管理不同环境的配置合理设置Pod的resources限制使用Sidecar模式管理数据库连接实现健康检查接口GetMapping(/health) public ResponseEntityString healthCheck() { try { userMapper.count(); return ResponseEntity.ok(UP); } catch (Exception e) { return ResponseEntity.status(503).body(DOWN); } }在实际项目开发中SpringBoot整合Mybatis的这套组合给我带来了极高的开发效率和足够的灵活性。特别是在处理复杂业务逻辑时能够自由编写优化过的SQL语句同时享受Spring的事务管理和依赖注入等特性。对于刚接触这套技术栈的开发者建议从简单的注解方式开始逐步过渡到XML配置最后再探索高级特性如插件开发和多数据源管理等。