在Spring Boot应用中，一旦检测到用户定义了任何DataSource bean，Spring Boot将停止其默认的DataSource自动配置，无论该自定义DataSource是否被标记为@Primary或具有特定名称。这意味着，即使你只需要一个辅助数据源，只要你手动定义了它，主数据源的自动配置也会被禁用，所有数据源都需要进行手动配置。
Spring Boot 自动配置原理：非侵入性设计
Spring Boot的自动配置机制旨在简化开发，通过分析项目的依赖和配置，自动为常见的组件（如数据库连接、Web服务器等）提供默认配置。其核心原则是“非侵入性”。这意味着，如果开发者选择提供自己的配置或组件实例，Spring Boot的自动配置就会“退让”，将控制权完全交给开发者。
对于DataSource而言，Spring Boot的文档明确指出：“如果你添加自己的DataSource bean，默认的嵌入式数据库支持将停止。”这里的关键在于“任何”DataSource bean。Spring Boot不会区分这是主数据源还是辅助数据源，也不会考虑是否使用了@Primary注解或特定的bean名称。只要容器中存在一个由用户显式定义的DataSource实例，Spring Boot就会认为开发者已决定自行管理数据源，从而停止所有与DataSource相关的默认自动配置。
自定义 DataSource 的影响：停止默认自动配置
当你在Spring Boot项目中定义了一个自定义的DataSource bean时，例如：
import org.springframework.boot.jdbc.DataSourceBuilder;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import javax.sql.DataSource;
@Configuration
public class CustomDataSourceConfig {
@Bean
public DataSource mySecondaryDataSource() {
return DataSourceBuilder.create()
.driverClassName("com.mysql.cj.jdbc.Driver")
.url("jdbc:mysql://localhost:3306/secondary_db")
.username("user")
.password("password")
.build();
}
}即使mySecondaryDataSource不是主数据源，也没有被@Primary注解，Spring Boot也会停止对主数据源的自动配置。这意味着，即使你的application.properties或application.yml中配置了spring.datasource.*属性，这些属性也不会被Spring Boot用于自动创建一个默认的DataSource bean。你将需要手动配置所有的DataSource实例。
多数据源场景下的配置策略
在需要配置多个数据源的场景下，由于自定义一个DataSource就会禁用自动配置，因此最稳妥且推荐的做法是完全手动配置所有数据源。这通常涉及以下步骤：
- 定义配置类： 创建一个或多个配置类，使用@Configuration注解。
- 定义 DataSource Bean： 为每个数据源定义一个@Bean方法，返回一个DataSource实例。
- 使用 @Primary 标记主数据源： 如果存在多个DataSource bean，并且没有明确指定，Spring在注入时会报错。使用@Primary注解可以明确指定哪个是首选的数据源。
- 绑定配置属性： 使用@ConfigurationProperties注解将外部配置文件（如application.yml）中的属性绑定到DataSource实例。
以下是一个手动配置两个数据源的示例：
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.boot.jdbc.DataSourceBuilder;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.Primary;
import javax.sql.DataSource;
@Configuration
public class MultipleDataSourcesConfig {
/**
* 配置主数据源
*/
@Bean
@Primary // 标记为主数据源，当存在多个DataSource时，这是默认注入的
@ConfigurationProperties("spring.datasource.primary") // 绑定以spring.datasource.primary开头的配置属性
public DataSource primaryDataSource() {
return DataSourceBuilder.create().build();
}
/**
* 配置辅助数据源
*/
@Bean
@ConfigurationProperties("spring.datasource.secondary") // 绑定以spring.datasource.secondary开头的配置属性
public DataSource secondaryDataSource() {
return DataSourceBuilder.create().build();
}
// 如果需要，可以进一步配置JdbcTemplate、EntityManagerFactory等
// 例如：
// @Bean
// public JdbcTemplate primaryJdbcTemplate(@Qualifier("primaryDataSource") DataSource dataSource) {
// return new JdbcTemplate(dataSource);
// }
}相应的application.yml配置可能如下：
spring:
datasource:
primary:
url: jdbc:mysql://localhost:3306/primary_db
username: primary_user
password: primary_password
driver-class-name: com.mysql.cj.jdbc.Driver
secondary:
url: jdbc:h2:mem:secondary_db
username: sa
password:
driver-class-name: org.h2.Driver验证自动配置行为：使用 --debug
如果你不确定某个自动配置是否被应用，或者想了解其被应用（或未被应用）的原因，可以在启动应用时添加--debug参数。
java -jar your-application.jar --debug
或在IDE中设置VM options：-Ddebug
这会启用核心日志记录器的调试日志，并在控制台输出一份“条件报告”（Conditions Report）。这份报告会详细列出所有自动配置类以及它们被匹配或不匹配的原因，这对于诊断DataSource自动配置是否生效非常有帮助。通过检查报告，你可以清晰地看到DataSourceAutoConfiguration是否因为存在用户定义的DataSource bean而退出了。
总结与注意事项
- “全有或全无”原则： 在Spring Boot中，对于DataSource的自动配置，一旦你手动定义了任何一个DataSource bean，Spring Boot就会停止所有默认的DataSource自动配置。你必须负责手动配置项目中的所有DataSource实例。
- @Primary和Bean名称的无关性： DataSource的自动配置是否停止，与你自定义的DataSource是否被@Primary注解或其bean名称无关。只要容器中存在自定义的DataSource实例，自动配置就会停止。
- 明确配置： 推荐在多数据源场景下，始终通过@Configuration和@Bean注解明确地定义和配置每一个DataSource，并利用@ConfigurationProperties进行外部化配置，以保持代码的清晰性和可维护性。
- 调试工具： 利用--debug启动参数生成条件报告，是理解Spring Boot自动配置行为的强大工具，尤其在处理复杂配置问题时。
