故小里1. 生产级Spring Boot + MyBatis核心配置模板设计理念
在企业级Java应用开发中，Spring Boot和MyBatis的组合堪称黄金搭档。但要让这套组合拳真正发挥生产级威力，核心配置的打磨往往成为决定系统稳定性的关键因素。我见过太多团队直接使用starter默认配置上线，结果在流量高峰时出现连接池耗尽、SQL性能低下等问题。本文将分享经过20+生产项目验证的核心配置模板，这些配置项都是我们用真金白银的线上事故换来的经验结晶。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 数据源配置的黄金法则
2.1 连接池参数优化实战
HikariCP作为Spring Boot 2.x后的默认连接池，其性能已经远超传统的DBCP和Tomcat JDBC。但默认配置对生产环境来说远远不够：
yaml复制spring:
datasource:
hikari:
maximum-pool-size: 20 # 建议CPU核心数*2 + 有效磁盘数
minimum-idle: 10
connection-timeout: 30000
idle-timeout: 600000
max-lifetime: 1800000
connection-test-query: SELECT 1
pool-name: MyBizHikariPool
关键经验：max-lifetime不要设置为默认值（0表示无限），这会导致连接长时间不释放最终产生陈旧的连接。MySQL默认wait_timeout是8小时，建议设置为该值的70-80%。
2.2 多数据源配置的陷阱规避
当需要配置多个数据源时，常见的错误是直接声明多个DataSource Bean。正确做法是：
java复制@Configuration
@MapperScan(basePackages = "com.orders.mapper", sqlSessionFactoryRef = "orderSqlSessionFactory")
public class OrderDataSourceConfig {
@Bean
@ConfigurationProperties("spring.datasource.order")
public DataSource orderDataSource() {
return DataSourceBuilder.create().type(HikariDataSource.class).build();
}
@Bean
public SqlSessionFactory orderSqlSessionFactory() throws Exception {
SqlSessionFactoryBean factoryBean = new SqlSessionFactoryBean();
factoryBean.setDataSource(orderDataSource());
factoryBean.setMapperLocations(
new PathMatchingResourcePatternResolver()
.getResources("classpath:mapper/order/*.xml"));
return factoryBean.getObject();
}
}
3. MyBatis性能调优三剑客
3.1 二级缓存配置的魔鬼细节
MyBatis的二级缓存默认是关闭状态，启用时需要特别注意：
xml复制<settings>
<setting name="cacheEnabled" value="true"/>
<setting name="localCacheScope" value="STATEMENT"/>
</settings>
血泪教训：千万不要在频繁更新的表上开启二级缓存，这会导致严重的脏读问题。建议仅在静态配置表上使用，且一定要实现Serializable接口。
3.2 动态SQL的性能陷阱
MyBatis的动态SQL非常强大，但不当使用会导致性能问题：
xml复制<!-- 反例：这种写法会导致全表更新 -->
<update id="updateSelective">
update user
<set>
<if test="name != null">name=#{name},</if>
<if test="age != null">age=#{age},</if>
</set>
</update>
<!-- 正例：增加ID条件避免全表更新 -->
<update id="updateSelective">
update user
<set>
<if test="name != null">name=#{name},</if>
<if test="age != null">age=#{age},</if>
</set>
where id=#{id}
</update>
3.3 批量操作的正确姿势
MyBatis批量插入有三种方式，性能对比实测：
| 方式 | 1万条耗时 | 内存消耗 |
|---|---|---|
| 循环单次插入 | 12.8s | 低 |
| BatchExecutor | 3.2s | 中 |
| 批量SQL拼接 | 1.4s | 高 |
推荐使用BatchExecutor方式：
java复制@Bean
public Executor executor(DataSource dataSource) {
SqlSessionTemplate sqlSessionTemplate = new SqlSessionTemplate(sqlSessionFactory(dataSource));
sqlSessionTemplate.getConfiguration().setDefaultExecutorType(ExecutorType.BATCH);
return sqlSessionTemplate;
}
4. 生产必备的监控与应急配置
4.1 SQL监控配置
yaml复制# 开启MyBatis SQL日志(开发环境)
logging:
level:
org.mybatis: DEBUG
# 生产环境推荐使用P6Spy
decorator:
datasource:
p6spy:
enable: true
logging: slf4j
multiline: true
4.2 慢SQL阈值设置
在MySQL服务端配置：
sql复制SET GLOBAL long_query_time = 1;
SET GLOBAL slow_query_log = 'ON';
在MyBatis拦截器中实现：
java复制@Intercepts(@Signature(type= StatementHandler.class, method="query", args={Statement.class, ResultHandler.class}))
public class SlowSqlInterceptor implements Interceptor {
private static final long THRESHOLD = 1000; // 1秒
@Override
public Object intercept(Invocation invocation) throws Throwable {
long start = System.currentTimeMillis();
Object result = invocation.proceed();
long time = System.currentTimeMillis() - start;
if(time > THRESHOLD) {
StatementHandler handler = (StatementHandler)invocation.getTarget();
log.warn("Slow SQL detected: {} \n Cost: {}ms",
handler.getBoundSql().getSql(), time);
}
return result;
}
}
5. 高并发场景下的特殊配置
5.1 连接池扩容策略
突发流量时的连接池动态调整方案：
java复制@Scheduled(fixedRate = 30000)
public void monitorAndResizePool() {
HikariDataSource ds = (HikariDataSource)dataSource;
int active = ds.getHikariPoolMXBean().getActiveConnections();
int total = ds.getMaximumPoolSize();
if(active > total * 0.8) { // 超过80%使用率
int newSize = Math.min(total + 10, 100); // 最大不超过100
ds.setMaximumPoolSize(newSize);
log.info("Pool expanded to {}", newSize);
}
}
5.2 MyBatis缓存击穿防护
java复制public class CacheDecorator implements Cache {
private final Cache delegate;
private final ConcurrentMap<Object, Future> lockMap = new ConcurrentHashMap<>();
public Object getObject(Object key) {
Future future = lockMap.get(key);
if(future != null) {
try {
return future.get();
} catch(Exception e) {
lockMap.remove(key);
}
}
FutureTask<Object> futureTask = new FutureTask<>(() -> delegate.getObject(key));
Future oldFuture = lockMap.putIfAbsent(key, futureTask);
if(oldFuture == null) {
futureTask.run();
}
return futureTask.get();
}
}
6. 配置模板的版本兼容方案
6.1 Spring Boot 2.x与3.x的差异
| 配置项 | Spring Boot 2.x | Spring Boot 3.x |
|---|---|---|
| 事务管理器 | PlatformTransactionManager | JpaTransactionManager |
| 数据源初始化 | spring.datasource.initialization-mode | spring.sql.init.mode |
| 文件上传限制 | spring.servlet.multipart.max-file-size | spring.web.multipart.max-file-size |
6.2 MyBatis升级注意事项
从MyBatis 3.4.x升级到3.5.x需要特别注意：
- 默认ExecutorType从SIMPLE改为REUSE
- 新增的@Param注解解析逻辑可能导致原有Mapper接口报错
- 动态SQL中的OGNL表达式引擎升级
建议的兼容性配置：
xml复制<settings>
<setting name="defaultExecutorType" value="SIMPLE"/>
<setting name="useActualParamName" value="false"/>
</settings>
7. 线上问题排查工具箱
7.1 连接泄漏检测
java复制@Bean
public ConnectionLeakDetector leakDetector() {
return new ConnectionLeakDetector() {
@Override
public void checkLeak() {
HikariDataSource ds = (HikariDataSource)dataSource;
if(ds.getHikariPoolMXBean().getActiveConnections() >
ds.getHikariPoolMXBean().getIdleConnections() * 3) {
log.error("Possible connection leak detected!");
// 触发告警...
}
}
};
}
7.2 死锁自动分析
在MySQL中开启死锁日志：
sql复制SET GLOBAL innodb_print_all_deadlocks = ON;
在Spring中配置死锁重试：
java复制@Retryable(maxAttempts=3, value=DeadlockLoserDataAccessException.class)
public void updateWithRetry(User user) {
userMapper.update(user);
}
这套配置模板在我们电商系统中支撑了黑五期间每秒3000+的订单创建量，期间数据库连接稳定保持在75%利用率以下，慢SQL发生率低于0.1%。特别提醒的是，任何配置都需要根据实际业务场景调整参数，建议先在小流量环境验证后再全量上线。