1. 为什么需要多数据源配置
在实际开发中,单数据源往往无法满足复杂业务需求。我遇到过不少需要同时操作多个数据库的场景,比如对接第三方系统时,对方只提供只读账号;业务数据量激增需要分库分表;或者不同业务模块需要隔离数据存储。这些都是典型的多数据源使用场景。
Spring Boot默认集成了HikariCP作为高性能连接池,但多数据源配置比单数据源复杂得多。很多开发者直接照搬网上教程,结果发现连接池参数不生效、事务管理混乱。我在项目迁移时就踩过这些坑,比如配置了最大连接数但实际还是默认值,导致高并发时连接不够用。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. HikariCP多数据源配置的常见陷阱
2.1 属性绑定层级错误
最常见的错误就是配置层级不对。比如这样写:
java复制@Bean
@ConfigurationProperties(prefix = "spring.datasource.primary")
public DataSource primaryDataSource() {
return DataSourceBuilder.create().build();
}
这种写法会导致hikari开头的连接池参数全部失效。因为HikariCP的配置实际在spring.datasource.primary.hikari层级,而上面的代码只能绑定到spring.datasource.primary这一层。
2.2 连接池参数不生效
即使配置了maximum-pool-size等参数,启动时发现还是用的默认值。这是因为:
- 没有正确指定
@ConfigurationProperties的前缀 - 没有显式指定
type = HikariDataSource.class - 配置项拼写错误(比如把
maxLifetime写成max-life-time)
2.3 事务管理器冲突
当配置多个数据源时,如果不明确指定事务管理器,Spring会随机选择一个,导致跨数据源事务失效。我遇到过明明配置了@Transactional但数据没有回滚的情况,就是因为这个原因。
3. 正确配置多数据源的最佳实践
3.1 分层配置属性
正确的做法是分两层配置:
yaml复制spring:
