AutoScan Spring Boot 项目底座跨包扫描的终极解决方案全解析

public class AutoScanApplicationContextInitializer implements ApplicationContextInitializer<ConfigurableApplicationContext> {
    @Override
    public void initialize(ConfigurableApplicationContext applicationContext) {
        // 检查 ApplicationContext 是否为 BeanDefinitionRegistry
        if (!(applicationContext instanceof BeanDefinitionRegistry registry)) {
            System.err.println(">>> [AutoScan] ApplicationContext is not a BeanDefinitionRegistry. Skip scanning.");
            return;
        }
        // 读取配置
        ConfigurableEnvironment environment = applicationContext.getEnvironment();
        List<String> basePackages = Binder.get(environment)
            .bind("auto-scan.base-packages", Bindable.listOf(String.class))
            .orElse(Collections.emptyList());
        // 构建扫描包列表
        Set<String> packagesToScan = new LinkedHashSet<>(basePackages);
        // 创建扫描器
        ClassPathBeanDefinitionScanner scanner = new ClassPathBeanDefinitionScanner(registry, false);
        scanner.addIncludeFilter(new AnnotationTypeFilter(Component.class));
        scanner.addIncludeFilter(new AnnotationTypeFilter(Configuration.class));
        // 执行扫描
        int scannedCount = scanner.scan(packagesToScan.toArray(new String[0]));
        System.out.println(">>> [AutoScan] Successfully registered " + scannedCount + " bean(s).");
    }
}

auto-scan:
  base-packages:
    - org.itrys.boot        # 核心框架包
    - org.itrys.common      # 公共组件包
    - org.itrys.security    # 安全组件包
  dev-mode: true

// 技术底座的启动类
package org.itrys.boot;
@SpringBootApplication
public class BootApplication { 
    public static void main(String[] args) {
        SpringApplication.run(BootApplication.class, args);
    }
}

auto-scan:
  base-packages:
    - org.itrys.boot        # 引入技术底座
    - com.company.framework # 业务框架包
    - com.company.security  # 安全组件包
  # business-packages 可选，仅当作为其他项目底座时配置
  business-packages:
    - com.company.business  # 业务通用包

<dependencies>
    <!-- 引入技术底座 -->
    <dependency>
        <groupId>org.itrys</groupId>
        <artifactId>ruoyi-boot-starter</artifactId>
    </dependency>
    <!-- 引入 autoscan -->
    <dependency>
        <groupId>org.itrys</groupId>
        <artifactId>autoscan-spring-boot-starter</artifactId>
    </dependency>
</dependencies>

# 只需配置依赖的基础包
auto-scan:
  base-packages:
    - org.itrys.boot        # 技术底座
    - com.company.framework # 业务底座

package com.company.project;
@SpringBootApplication  // 自动扫描 com.company.project 包及其子包
public class ProjectApplication {
    public static void main(String[] args) {
        SpringApplication.run(ProjectApplication.class, args);
    }
}

>>> [AutoScan] Initializing base package scanner...
>>> [AutoScan] Configured base packages: [org.itrys.boot, com.company.framework]
>>> [AutoScan] Final packages to scan: [org.itrys.boot, com.company.framework]
>>> [AutoScan] Successfully registered 58 bean(s) from base packages.

Starting ProjectApplication using Java 21...
Scanning for additional bean definitions in package [com.company.project]

技术底座（org.itrys.boot）
    ↓
业务底座A（com.company.framework）
    ↓
业务底座B（com.company.platform）
    ↓
具体业务项目（com.company.project.xxx）