dynamic-datasource启动时initial loaded [0] datasource，主数据源未注册

Question

在使用 dynamic-datasource-spring-boot-starter 时，启动日志出现 `initial loaded [0] datasource` 且主数据源未注册，是典型配置失效问题。常见原因包括：① 未正确添加 `@EnableDynamicDataSource` 注解（3.x 版本已弃用，需确认版本适配）；② `spring.datasource.dynamic.primary` 配置缺失或拼写错误（如误写为 `primary-datasource`）；③ 主数据源 Bean 被重复定义（如手动 `@Bean` 创建了 `DataSource`，与 dynamic-datasource 自动装配冲突）；④ 多模块项目中 `application.yml` 加载顺序异常，导致 dynamic-datasource 配置未生效；⑤ Spring Boot 版本与 dynamic-datasource 版本不兼容（如 Boot 3.x 需用 dynamic-datasource 4.x）。排查建议：检查 `DynamicDataSourceAutoConfiguration` 是否成功加载、验证 `DynamicRoutingDataSource` Bean 是否存在，以及启用 `debug=true` 查看自动配置报告。核心原则：主数据源必须通过 dynamic-datasource 的配置驱动注册，而非传统 `DataSource` 手动注入。

Answer 1

```html

一、现象定位：从日志线索切入问题本质

启动时输出 initial loaded [0] datasource 是 dynamic-datasource-spring-boot-starter 的关键失败信号，表明 DynamicRoutingDataSource 初始化时未加载任何数据源（含主数据源）。该日志由 DynamicDataSourceCreator#build 方法触发，其前置条件是 DynamicDataSourceAutoConfiguration 已完成且配置非空。此时若为 0，说明配置未抵达自动装配上下文，或被提前拦截/覆盖。

二、版本对齐：兼容性是前提，非可选优化项

Spring Boot 版本	dynamic-datasource 推荐版本	关键变更说明
2.7.x	3.5.2	仍支持 @EnableDynamicDataSource，但已标记 @Deprecated
3.0.x / 3.2.x	4.3.0+	完全移除注解驱动，依赖 DynamicDataSourceAutoConfiguration 条件化加载；强制要求 Jakarta EE 9+ 命名空间

执行 mvn dependency:tree | grep dynamic 验证实际引入版本，并检查 META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports 中是否包含 com.baomidou.dynamic.datasource.spring.boot.autoconfigure.DynamicDataSourceAutoConfiguration。

三、配置解析链路：yml → PropertySource → ConfigurationProperties → AutoConfig

dynamic-datasource 的配置生效依赖完整解析链：

1. application.yml 加载为 ConfigurationPropertySources（注意：多模块中若 bootstrap.yml 或 @PropertySource 优先级更高，可能屏蔽 dynamic 配置）
2. DynamicDataSourceProperties 绑定前缀 spring.datasource.dynamic，需严格匹配大小写与连字符（如 primary 不可写作 primary-datasource）
3. 最终由 DynamicDataSourceAutoConfiguration 的 @ConditionalOnProperty("spring.datasource.dynamic.enabled") 控制激活

四、Bean 注册冲突：手动定义 DataSource 是高频雷区

以下代码将导致 dynamic-datasource 自动装配失效：

@Configuration
public class DataSourceConfig {
    @Bean
    public DataSource dataSource() { // ❌ 冲突！dynamic 会跳过自动注册
        return new HikariDataSource();
    }
}

正确做法是：彻底删除所有显式 @Bean DataSource，仅通过 yml 配置主从数据源：

spring:
  datasource:
    dynamic:
      primary: master
      strict: false
      datasource:
        master:
          driver-class-name: com.mysql.cj.jdbc.Driver
          jdbc-url: jdbc:mysql://localhost:3306/db1
          username: root
          password: 123456

五、诊断流程图：结构化排查路径

graph TD
    A[启动日志出现 initial loaded [0] datasource] --> B{启用 debug=true?}
    B -->|是| C[查看 Auto-configuration Report]
    B -->|否| D[手动检查 DynamicDataSourceAutoConfiguration 是否在 report 中]
    C --> E[确认 DynamicDataSourceAutoConfiguration: matched = true]
    E --> F[检查 DynamicRoutingDataSource Bean 是否存在]
    F -->|不存在| G[验证 spring.datasource.dynamic.primary 是否配置且拼写正确]
    F -->|存在| H[检查是否有 @Primary DataSource Bean 干扰]
    G --> I[检查多模块中 application.yml 是否被 profile 覆盖]

六、高级验证：运行时反射探针

在 @PostConstruct 或 Actuator Endpoint 中注入 ApplicationContext，执行：

boolean autoConfigLoaded = applicationContext.getBeanFactory()
    .containsBeanDefinition("dynamicDataSourceAutoConfiguration");

Object routingDS = applicationContext.getBean("dynamicRoutingDataSource");
log.info("Routing DS class: {}", routingDS.getClass().getName());

// 输出所有 DataSource 类型 Bean 名称
String[] dsBeans = applicationContext.getBeanNamesForType(DataSource.class);
log.info("All DataSource beans: {}", Arrays.toString(dsBeans)); // 应含 dynamicRoutingDataSource，不含 user-defined dataSource

若 dsBeans 包含 dataSource（非 dynamicRoutingDataSource），即证实手动定义污染。

七、核心原则重申：配置即契约，约定大于配置

dynamic-datasource 的设计哲学是“配置驱动注册”，而非 Spring 传统 Bean 手动注入模式。主数据源必须通过 spring.datasource.dynamic.datasource.[name] 显式声明，由 DynamicDataSourceCreator 统一构建并注册至 DynamicRoutingDataSource 的 targetDataSources Map 中。任何绕过该机制的 DataSource 定义，都将导致路由失效、事务异常、@DS 注解无响应等连锁故障。

```