问题：DataSourceDefaultConfig提示缺少MyBatis Plus数据源Bean

Question

在使用 MyBatis Plus 多数据源配置时，开发者常遇到“DataSourceDefaultConfig 提示缺少 MyBatis Plus 数据源 Bean”的问题。该异常通常发生在未正确配置默认数据源或未将主数据源标记为 `@Primary` 时。MyBatis Plus 在启动过程中会尝试加载默认数据源 Bean，若找不到符合条件的 Bean，则抛出此提示。常见原因包括：数据源 Bean 未被正确注入、多数据源场景下未指定主数据源、或配置类遗漏了对数据源的初始化逻辑。解决方法包括检查 `application.yml` 或 `properties` 文件中的数据库连接信息是否完整、确保至少一个数据源 Bean 被标注为 `@Primary`，以及确认是否引入了正确的 MyBatis Plus 多数据源依赖与配置类。

Answer 1

一、问题背景与常见现象

在使用 MyBatis Plus 进行多数据源配置时，开发者常常会遇到如下异常提示：

DataSourceDefaultConfig 提示缺少 MyBatis Plus 数据源 Bean

该提示通常出现在 Spring Boot 项目启动过程中。MyBatis Plus 在初始化阶段会尝试加载默认的数据源 Bean（即主数据源），若找不到符合条件的 Bean，则会抛出此异常。

这个问题的核心在于：Spring 容器中没有一个被识别为主数据源的 Bean，或者多个数据源未正确标注主数据源。

二、常见原因分析

• 数据源 Bean 没有被正确注入到 Spring 容器中；
• 在多数据源配置下，未指定哪个数据源为“主数据源”（缺少 @Primary 注解）；
• 配置类中遗漏了对数据源的初始化逻辑；
• 未引入正确的 MyBatis Plus 多数据源依赖或配置类；
• 数据库连接信息（如 URL、用户名、密码等）在配置文件中不完整或错误。

三、解决方案详解

以下为解决该问题的几种关键方法，按优先级和常见性排序：

1. 确保至少一个数据源 Bean 被标注为 @Primary

   @Bean
   @Primary
   @Configuration
   public class DataSourceConfig {
       @Bean
       public DataSource primaryDataSource() {
           return DataSourceBuilder.create()
                   .url("jdbc:mysql://localhost:3306/db1")
                   .username("root")
                   .password("root")
                   .build();
       }
   }

2. 检查 application.yml 或 application.properties 文件中的数据库连接信息是否完整

   配置项	值示例
   spring.datasource.url	jdbc:mysql://localhost:3306/db1
   spring.datasource.username	root
   spring.datasource.password	root
   spring.datasource.driver-class-name	com.mysql.cj.jdbc.Driver

3. 确认是否引入了正确的 MyBatis Plus 多数据源依赖与配置类

   例如使用 dynamic-datasource-spring-boot-starter 作为多数据源管理方案：

   implementation 'com.baomidou:dynamic-datasource-spring-boot-starter:4.2.0'

4. 手动定义多个数据源并使用 @DS 注解切换数据源

   @Service
   @DS("db1")
   public class UserServiceImpl implements UserService {
       // ...
   }

四、进阶建议与调试技巧

为了更高效地排查此类问题，可以采用以下进阶手段：

• 使用 @ConditionalOnMissingBean 来判断某个 Bean 是否缺失；
• 通过 Spring Boot Actuator 的 /actuator/beans 接口查看当前容器中注册的所有数据源 Bean；
• 启用日志输出，观察 Spring 启动时的数据源加载过程；
• 使用 IDE 的断点调试功能，在 MyBatis Plus 初始化阶段追踪数据源加载流程。

五、典型配置流程图

graph TD
            A[开始] --> B[检查配置文件]
            B --> C{是否存在主数据源配置?}
            C -- 是 --> D[标记为@Primary]
            C -- 否 --> E[添加主数据源配置]
            D --> F[检查依赖是否引入]
            E --> F
            F --> G{依赖是否完整?}
            G -- 是 --> H[启动应用]
            G -- 否 --> I[补充依赖后重试]
            H --> J[结束]
            I --> J