1. 项目概述作为一名长期奋战在Java开发一线的工程师我深知MyBatis作为ORM框架在企业级应用中的重要性。SpringBoot3作为当前最主流的Java应用框架与MyBatis的整合是每个Java开发者必须掌握的核心技能。本文将基于最新技术栈手把手带你完成SpringBoot3与MyBatis的深度整合并分享我在实际项目中积累的宝贵经验。这个整合方案已经在我负责的多个生产级项目中得到验证能够稳定支撑高并发场景。不同于简单的配置教程我会重点讲解每个配置项背后的设计原理以及如何根据项目特点进行定制化调整。无论你是刚接触MyBatis的新手还是希望优化现有项目的老鸟都能从本文中获得实用价值。2. 环境准备与依赖配置2.1 项目初始化首先使用Spring Initializr创建一个基础项目选择以下核心依赖Spring Web (用于构建Controller层)Lombok (可选简化实体类编写)Spring Boot版本选择3.1.0提示虽然Lombok能简化代码但在团队协作项目中建议谨慎使用避免因IDE插件不一致导致编译问题。本文示例将展示完整的getter/setter写法。2.2 数据库驱动配置MySQL驱动是连接数据库的基础在pom.xml中添加以下依赖dependency groupIdcom.mysql/groupId artifactIdmysql-connector-j/artifactId !-- 不指定版本由SpringBoot自动管理 -- /dependency版本选择策略对于生产环境建议锁定具体版本如8.0.32开发环境可以使用SpringBoot管理的默认版本特别注意MySQL 8.0必须使用mysql-connector-j而非老版的mysql-connector-java2.3 MyBatis核心依赖添加MyBatis官方提供的SpringBoot Starterdependency groupIdorg.mybatis.spring.boot/groupId artifactIdmybatis-spring-boot-starter/artifactId version3.0.3/version /dependency版本选择建议3.0.x系列全面支持SpringBoot32.3.x系列兼容SpringBoot2.x生产环境务必检查版本兼容性矩阵3. 数据源与MyBatis配置3.1 数据源详细配置在application.yml中配置HikariCP连接池SpringBoot默认使用spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/test?useUnicodetruecharacterEncodingutf-8useSSLfalseserverTimezoneAsia/Shanghai username: root password: 12345678 hikari: connection-timeout: 30000 maximum-pool-size: 20 minimum-idle: 5 idle-timeout: 600000 max-lifetime: 1800000关键参数解析connection-timeout连接获取超时时间毫秒maximum-pool-size连接池最大连接数根据服务器CPU核心数调整minimum-idle最小空闲连接数建议设为max-pool-size的1/43.2 MyBatis高级配置mybatis: mapper-locations: classpath:mybatis/**/*.xml type-aliases-package: com.example.demo.entity configuration: map-underscore-to-camel-case: true default-fetch-size: 100 default-statement-timeout: 30 cache-enabled: true性能优化要点default-fetch-size控制JDBC每次从数据库获取的行数statement-timeoutSQL执行超时时间秒cache-enabled二级缓存开关分布式环境需要额外配置4. 业务层开发实战4.1 实体类设计以学生表为例演示标准的JavaBean写法package com.example.demo.entity; public class Student { private Integer id; private String name; private Integer age; private String otherMessage; // 完整构造方法 public Student(Integer id, String name, Integer age, String otherMessage) { this.id id; this.name name; this.age age; this.otherMessage otherMessage; } // getters and setters public Integer getId() { return id; } public void setId(Integer id) { this.id id; } // 其他getter/setter省略... }设计规范使用包装类型Integer而非基本类型int避免NULL问题字段名严格遵循驼峰命名必须提供完整的getter/setter4.2 Mapper接口开发Mapper public interface StudentMapper { Select(SELECT * FROM student WHERE id #{id}) Student selectById(Param(id) Integer id); Insert(INSERT INTO student(id, name, age, other_message) VALUES(#{id}, #{name}, #{age}, #{otherMessage})) int insert(Student student); Update(UPDATE student SET name#{name}, age#{age}, other_message#{otherMessage} WHERE id#{id}) int update(Student student); Delete(DELETE FROM student WHERE id#{id}) int deleteById(Param(id) Integer id); }接口设计技巧简单SQL可以直接使用注解复杂SQL建议使用XML配置参数超过2个时使用Param注解明确指定4.3 XML映射文件配置在resources/mybatis/目录下创建StudentMapper.xml?xml version1.0 encodingUTF-8? !DOCTYPE mapper PUBLIC -//mybatis.org//DTD Mapper 3.0//EN http://mybatis.org/dtd/mybatis-3-mapper.dtd mapper namespacecom.example.demo.mapper.StudentMapper resultMap idBaseResultMap typeStudent id columnid propertyid jdbcTypeINTEGER/ result columnname propertyname jdbcTypeVARCHAR/ result columnage propertyage jdbcTypeINTEGER/ result columnother_message propertyotherMessage jdbcTypeVARCHAR/ /resultMap select idselectByCondition resultMapBaseResultMap SELECT * FROM student where if testname ! null AND name LIKE CONCAT(%, #{name}, %) /if if testage ! null AND age #{age} /if /where /select /mapperXML开发要点使用resultMap明确字段映射关系动态SQL使用where和if标签模糊查询使用CONCAT函数保证SQL注入安全5. 控制层与集成测试5.1 RESTful接口开发RestController RequestMapping(/api/students) public class StudentController { private final StudentMapper studentMapper; public StudentController(StudentMapper studentMapper) { this.studentMapper studentMapper; } GetMapping(/{id}) public ResponseEntityStudent getById(PathVariable Integer id) { Student student studentMapper.selectById(id); return ResponseEntity.ok(student); } PostMapping public ResponseEntityVoid create(RequestBody Student student) { studentMapper.insert(student); return ResponseEntity.created(URI.create(/api/students/ student.getId())).build(); } GetMapping public ResponseEntityListStudent queryByCondition( RequestParam(required false) String name, RequestParam(required false) Integer age) { ListStudent students studentMapper.selectByCondition(name, age); return ResponseEntity.ok(students); } }REST设计规范使用HTTP状态码正确反映操作结果POST成功返回201 CreatedGET查询使用RequestParam接收条件参数5.2 启动类配置SpringBootApplication MapperScan(com.example.demo.mapper) public class DemoApplication { public static void main(String[] args) { SpringApplication.run(DemoApplication.class, args); } }扫描配置要点MapperScan指定Mapper接口所在包可以配置多个包路径用逗号分隔避免扫描范围过大影响启动速度6. 高级特性与性能优化6.1 分页查询实现使用PageHelper实现物理分页添加依赖dependency groupIdcom.github.pagehelper/groupId artifactIdpagehelper-spring-boot-starter/artifactId version1.4.6/version /dependency在Controller中使用GetMapping(/page) public ResponseEntityPageInfoStudent queryByPage( RequestParam(defaultValue 1) Integer pageNum, RequestParam(defaultValue 10) Integer pageSize) { PageHelper.startPage(pageNum, pageSize); ListStudent students studentMapper.selectAll(); return ResponseEntity.ok(new PageInfo(students)); }6.2 事务管理在Service层添加事务控制Service RequiredArgsConstructor public class StudentService { private final StudentMapper studentMapper; Transactional public void updateStudent(Student student) { studentMapper.update(student); // 其他数据库操作... } }事务使用要点默认只对RuntimeException回滚需要检查异常回滚时使用Transactional(rollbackFor Exception.class)避免在事务方法中进行远程调用6.3 多数据源配置对于需要连接多个数据库的场景配置多个数据源spring: datasource: primary: url: jdbc:mysql://localhost:3306/db1 username: root password: 123456 secondary: url: jdbc:mysql://localhost:3306/db2 username: root password: 123456创建配置类Configuration public class DataSourceConfig { Bean Primary ConfigurationProperties(spring.datasource.primary) public DataSource primaryDataSource() { return DataSourceBuilder.create().build(); } Bean ConfigurationProperties(spring.datasource.secondary) public DataSource secondaryDataSource() { return DataSourceBuilder.create().build(); } }7. 常见问题排查7.1 启动时报Mapper找不到现象启动时抛出Invalid bound statement (not found)异常解决方案检查MapperScan路径是否正确确认XML文件是否在mapper-locations指定路径下检查XML中的namespace是否与Mapper接口全限定名一致7.2 字段映射失败现象查询结果中某些字段为null排查步骤确认数据库字段名与实体类属性名对应关系检查是否开启了map-underscore-to-camel-case复杂映射使用resultMap明确指定7.3 性能问题优化慢SQL排查开启MyBatis日志logging: level: com.example.demo.mapper: debug使用Druid等连接池的监控功能对复杂SQL进行EXPLAIN分析8. 生产环境最佳实践8.1 连接池监控建议使用Druid连接池替代HikariCP提供更丰富的监控功能dependency groupIdcom.alibaba/groupId artifactIddruid-spring-boot-starter/artifactId version1.2.16/version /dependency配置监控界面Configuration public class DruidConfig { Bean public ServletRegistrationBeanStatViewServlet druidServlet() { ServletRegistrationBeanStatViewServlet reg new ServletRegistrationBean(); reg.setServlet(new StatViewServlet()); reg.addUrlMappings(/druid/*); return reg; } }8.2 SQL审计与防护防范SQL注入攻击永远不要拼接SQL语句使用#{}而非${}占位符对用户输入进行严格校验8.3 缓存策略优化二级缓存配置示例cache evictionLRU flushInterval60000 size1024 readOnlytrue/缓存使用建议读多写少的场景使用缓存分布式环境需要集成Redis等集中式缓存及时更新缓存避免脏数据经过以上步骤我们不仅完成了SpringBoot3与MyBatis的基础整合还涵盖了生产环境中常见的各种高级配置和优化策略。在实际项目开发中建议根据具体业务需求选择合适的配置方案并建立完善的监控体系确保系统稳定高效运行。