### Dynamic-
Datasource Spr
ing Boot
配置教程及常见
问题解决方案
####
1. Dynamic-
Datasource 简介
Dynamic-
Datasource 是一个基于 Spr
ing Boot 的开源多数据源解决方案，支持多种
数据库（如 MySQL、Oracle、SQL Server 等），并提供动态切换数据源的功能[^3]。它可以通过
配置文件或注解的方式自动
配置数据源，并支持自定义数据源路由规则。
#### 2
. 配置步骤
##### 2
.1 引入依赖
在 `pom
.xml` 文件中添加以下依赖：
```xml
<dependency>
<groupId>com
.baomidou</groupId>
<artifactId>dynamic-
datasource-spr
ing-boot-starter</artifactId>
<version>3
.5
.0</version>
</dependency>
```
##### 2
.2
配置多数据源
在 `application
.yml` 文件中
配置多个数据源：
```yaml
spr
ing:
datasource:
dynamic:
primary: master # 设置主数据源
strict: false # 是否严格匹配数据源
datasource:
master:
url:
jdbc:mysql://localhost:3306/master_db?useUnicode=true&characterEncod
ing=utf8&serverTimezone=UTC&useSSL=false
username: root
password: root
driver-class-name: com
.mysql
.cj
.jdbc.Driver
slave
1:
url:
jdbc:mysql://localhost:3306/slave
1_db?useUnicode=true&characterEncod
ing=utf8&serverTimezone=UTC&useSSL=false
username: root
password: root
driver-class-name: com
.mysql
.cj
.jdbc.Driver
slave2:
url:
jdbc:mysql://localhost:3306/slave2_db?useUnicode=true&characterEncod
ing=utf8&serverTimezone=UTC&useSSL=false
username: root
password: root
driver-class-name: com
.mysql
.cj
.jdbc.Driver
```
##### 2
.3
配置事务管理器
将动态数据源加载类 `Dynamic
DataSource` 添加到事务管理器中：
```java
@Bean
public
DataSourceTransactionManager transactionManager(Dynamic
DataSource dynamic
DataSource) {
return new
DataSourceTransactionManager(dynamic
DataSource);
}
```
上述代码确保了事务管理器能够正确识别动态数据源[^4]。
##### 2
.4 自定义数据源切换逻辑
通过 `@DS` 注解实现动态切换数据源：
```java
@Service
public class UserService {
@Autowired
private UserMapper userMapper;
// 切换到 master 数据源
@DS("master")
public List<User> getUsersFromMaster() {
return userMapper
.selectList(null);
}
// 切换到 slave
1 数据源
@DS("slave
1")
public List<User> getUsersFromSlave
1() {
return userMapper
.selectList(null);
}
}
```
#### 3
. 常见
问题及解决方案
##### 3
.1 数据源无法切换
**原因**：可能未正确
配置 `@DS` 注解或未设置主数据源。
**解决方案**：确保 `application
.yml` 中设置了 `primary` 属性，并在需要切换数据源的地方使用 `@DS` 注解指定目标数据源[^3]。
##### 3
.2
数据库连接池
配置错误
**原因**：连接池参数
配置不合理，可能导致连接超时或资源耗尽。
**解决方案**：根据业务需求调整连接池大小、空闲连接数等参数。例如：
```yaml
spr
ing:
datasource:
dynamic:
datasource:
master:
hikari:
maximum-pool-size: 20
idle-timeout: 30000
```
##### 3
.3 事务管理失效
**原因**：动态数据源未正确注册到事务管理器中。
**解决方案**：确保在
配置类中将 `Dynamic
DataSource` 实例注入到 `
DataSourceTransactionManager` 中[^4]。
##### 3
.4 查询结果为空
**原因**：可能是数据源
配置错误或表结构不一致。
**解决方案**：检查各数据源的 URL、用户名和密码是否正确，并确认表结构是否一致。
#### 4
. 示例代码
以下是一个完整的动态数据源
配置示例：
```java
@
Configuration
public class
DataSourceConfig {
@Bean
@
ConfigurationProperties(prefix = "spr
ing
.datasource.dynamic")
public Dynamic
DataSource dataSource() {
return new Dynamic
DataSource();
}
@Bean
public
DataSourceTransactionManager transactionManager(Dynamic
DataSource dynamic
DataSource) {
return new
DataSourceTransactionManager(dynamic
DataSource);
}
}
```
###
本文分享了作者在使用JDBC进行项目开发过程中遇到的DataSource配置问题及解决方法，包括resource标签大小写敏感问题和Cannot load JDBC driver错误的解决办法。
扫一扫
1万+
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
