黑河市all1. 项目背景与核心需求
在现代企业级应用开发中，多数据源访问已经成为标配需求。一个典型的电商系统可能需要同时连接：
- 用户中心的MySQL数据库
- 订单系统的SQL Server数据库
- 日志分析的PostgreSQL数据库
传统单数据源配置在Spring Boot中非常简单，但多数据源场景下会遇到几个典型问题：
- 如何区分不同数据源的JDBC配置
- 事务管理器如何隔离不同数据源
- MyBatis映射文件如何动态切换数据源
最近在技术社区看到不少开发者遇到"Failed to configure a DataSource: 'url' attribute"这类错误，本质上都是多数据源配置不当导致的。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 技术方案选型
2.1 主流方案对比
| 方案 | 优点 | 缺点 |
|---|---|---|
| 手动配置多个DataSource | 完全可控 | 需要自行处理事务和切换逻辑 |
| AbstractRoutingDataSource | Spring原生支持 | 需要实现动态路由逻辑 |
| dynamic-datasource-spring-boot-starter | 开箱即用 | 学习成本略高 |
经过实际项目验证，我推荐使用dynamic-datasource这个开源组件，它完美解决了以下痛点：
- 基于注解的声明式数据源切换
- 内置分布式事务支持
- 与MyBatis Plus无缝集成
2.2 版本兼容性确认
在开始前需要特别注意版本匹配：
- Spring Boot 2.7.x → dynamic-datasource 3.6.0
- MyBatis Plus 3.5.x → 需要排除HikariCP自动配置
重要提示：如果项目中使用Spring Boot 3.x，需要使用dynamic-datasource 4.x版本，两者API有较大差异
3. 详细实现步骤
3.1 依赖配置
首先在pom.xml中添加关键依赖：
xml复制<dependency>
<groupId>com.baomidou</groupId>
<artifactId>dynamic-datasource-spring-boot-starter</artifactId>
<version>3.6.0</version>
</dependency>
<!-- 必须排除默认数据源 -->
<exclusions>
<exclusion>
<groupId>com.zaxxer</groupId>
<artifactId>HikariCP</artifactId>
</exclusion>
</exclusions>
3.2 多数据源配置
application.yml配置示例：
yaml复制spring:
datasource:
dynamic:
primary: master # 默认数据源
strict: true # 严格匹配数据源
datasource:
master:
url: jdbc:mysql://localhost:3306/user_db
username: root
password: 123456
driver-class-name: com.mysql.cj.jdbc.Driver
order:
url: jdbc:sqlserver://localhost:1433;databaseName=order_db
username: sa
password: yourStrongPassword
driver-class-name: com.microsoft.sqlserver.jdbc.SQLServerDriver
3.3 MyBatis Plus集成
在Mapper接口上使用@DS注解切换数据源：
java复制@Repository
@DS("master") // 默认使用主库
public interface UserMapper extends BaseMapper<User> {
@Select("SELECT * FROM users")
List<User> selectAll();
}
@Repository
@DS("order") // 指定使用订单库
public interface OrderMapper extends BaseMapper<Order> {
@Select("SELECT * FROM orders WHERE user_id = #{userId}")
List<Order> selectByUserId(Long userId);
}
4. 高级配置与优化
4.1 事务管理配置
多数据源事务需要特殊处理：
java复制@Configuration
public class TransactionConfig {
@Bean
public PlatformTransactionManager transactionManager(DynamicDataSource dataSource) {
return new DataSourceTransactionManager(dataSource);
}
}
4.2 连接池调优
建议为不同业务库配置独立的连接池参数：
yaml复制spring:
datasource:
dynamic:
datasource:
master:
hikari:
maximum-pool-size: 20
connection-timeout: 30000
order:
hikari:
maximum-pool-size: 10
connection-timeout: 60000
5. 常见问题排查
5.1 驱动加载失败
典型错误现象：
code复制java.lang.RuntimeException: Failed to load driver class com.microsoft.sqlserver.jdbc.SQLServerDriver
解决方案：
- 确认pom.xml中包含对应JDBC驱动
- 检查驱动类名拼写（SQLServer区分大小写）
- 对于SQL Server需要额外添加依赖：
xml复制<dependency>
<groupId>com.microsoft.sqlserver</groupId>
<artifactId>mssql-jdbc</artifactId>
<version>9.4.1.jre8</version>
</dependency>
5.2 事务不生效
当出现跨数据源事务时，需要引入Seata等分布式事务解决方案：
java复制@DS("order")
@Transactional(rollbackFor = Exception.class)
public void createOrder(Order order) {
orderMapper.insert(order);
// 跨库操作
userMapper.updateBalance(order.getUserId(), order.getAmount());
}
6. 性能优化建议
- 连接池监控：集成Druid的监控界面
- SQL优化：为不同数据库编写方言特定的SQL
- 缓存策略：对读多写少的数据启用二级缓存
- 批量操作：对于SQL Server特别要注意批量插入的语法差异
实际项目中，我们通过以下配置将查询性能提升了40%：
yaml复制mybatis-plus:
configuration:
default-executor-type: BATCH
cache-enabled: true
7. 安全注意事项
- 密码加密：使用Jasypt等工具加密配置中的密码
- SQL注入防护：始终使用预编译语句
- 权限控制：数据库账号应该遵循最小权限原则
- 连接泄露检测：启用连接泄露检测机制
对于生产环境，建议添加如下配置：
yaml复制spring:
datasource:
dynamic:
datasource:
master:
hikari:
leak-detection-threshold: 60000 # 60秒泄漏检测
8. 扩展应用场景
这种多数据源架构特别适合：
- 数据库迁移过程中的双写方案
- 分库分表场景下的路由控制
- 多租户SaaS应用的数据隔离
- 读写分离架构的实现
最近在金融项目中，我们就用这种方案实现了：
- 核心交易数据存Oracle
- 用户行为数据存MongoDB
- 报表数据存ClickHouse
通过自定义AbstractRoutingDataSource，可以实现更复杂的路由逻辑，比如根据租户ID自动选择数据源。