Spring Boot：无需@ComponentScan的Bean配置方案咨询

针对你当前多个@ComponentScan导致的配置冗余和过度扫描问题，以下是几种实用的优化思路：

方案1：合并单个@ComponentScan，精准控制扫描范围与过滤规则 #

将多个@ComponentScan合并为一个，通过指定所有需要的根包，并集中配置includeFilters来只加载指定类，避免无关组件被扫描。

@SpringBootApplication
@ComponentScan(
        basePackages = {
                "net.gencat.transversal.espaidoc.frontoffice", // 主类所在包，替换为实际包路径
                "net.gencat.transversal.espaidoc.storage.application",
                "net.gencat.transversal.espaidoc.storage.infrastructure"
        },
        includeFilters = {
                @ComponentScan.Filter(
                        type = FilterType.ASSIGNABLE_TYPE,
                        classes = {
                                PushDocumentMapper.class,
                                PushDocumentInputPort.class,
                                PullDocumentInputPort.class,
                                IdentityContextMapper.class,
                                PushDocumentIdentityContextOutputPort.class,
                                PullDocumentIdentityContextOutputPort.class
                        }
                )
        },
        useDefaultFilters = false // 关闭默认组件扫描规则，仅加载指定类
)
@EnableMongoRepositories(basePackages = "net.gencat.transversal.espaidoc.storage.infrastructure")
@EnableScheduling
public class FrontofficeApplication {
}

注意：如果主类所在包下还有其他需要自动扫描的组件，将useDefaultFilters设为true即可，此时默认规则会扫描主类包下的组件，同时includeFilters会额外加载指定类。

方案2：手动注册Bean，完全避免扫描 #

既然你明确知道需要加载的类，直接通过@Configuration类手动注册每个Bean，完全跳过组件扫描环节，最精准也最无冗余。

主类配置 #

@SpringBootApplication(scanBasePackages = "net.gencat.transversal.espaidoc.frontoffice") // 仅扫描主类所在包的必要组件
@EnableMongoRepositories(basePackages = "net.gencat.transversal.espaidoc.storage.infrastructure")
@EnableScheduling
public class FrontofficeApplication {
}

新建Bean配置类 #

@Configuration
public class StorageBeanRegistry {
    // 注册application层Bean
    @Bean
    public PushDocumentMapper pushDocumentMapper() {
        return new PushDocumentMapper();
    }

    @Bean
    public PushDocumentInputPort pushDocumentInputPort() {
        // 替换为实际实现类
        return new PushDocumentInputPortImpl();
    }

    @Bean
    public PullDocumentInputPort pullDocumentInputPort() {
        return new PullDocumentInputPortImpl();
    }

    // 注册infrastructure层Bean
    @Bean
    public IdentityContextMapper identityContextMapper() {
        return new IdentityContextMapper();
    }

    @Bean
    public PushDocumentIdentityContextOutputPort pushDocumentIdentityContextOutputPort() {
        return new PushDocumentIdentityContextOutputPortImpl();
    }

    @Bean
    public PullDocumentIdentityContextOutputPort pullDocumentIdentityContextOutputPort() {
        return new PullDocumentIdentityContextOutputPortImpl();
    }
}

方案3：模块化拆分配置类，利用Spring自动扫描配置类 #

将不同模块的Bean配置拆分到对应包下的@Configuration类中，主类仅扫描包含这些配置类的根包，既避免全局复杂过滤，又符合模块化管理。

application层配置类（放在net.gencat.transversal.espaidoc.storage.application包下） #

@Configuration
public class StorageApplicationConfig {
    @Bean
    public PushDocumentMapper pushDocumentMapper() {
        return new PushDocumentMapper();
    }

    @Bean
    public PushDocumentInputPort pushDocumentInputPort() {
        return new PushDocumentInputPortImpl();
    }

    @Bean
    public PullDocumentInputPort pullDocumentInputPort() {
        return new PullDocumentInputPortImpl();
    }
}

infrastructure层配置类（放在net.gencat.transversal.espaidoc.storage.infrastructure包下） #

@Configuration
public class StorageInfrastructureConfig {
    @Bean
    public IdentityContextMapper identityContextMapper() {
        return new IdentityContextMapper();
    }

    @Bean
    public PushDocumentIdentityContextOutputPort pushDocumentIdentityContextOutputPort() {
        return new PushDocumentIdentityContextOutputPortImpl();
    }

    @Bean
    public PullDocumentIdentityContextOutputPort pullDocumentIdentityContextOutputPort() {
        return new PullDocumentIdentityContextOutputPortImpl();
    }
}

主类配置 #

@SpringBootApplication(scanBasePackages = {
        "net.gencat.transversal.espaidoc.frontoffice",
        "net.gencat.transversal.espaidoc.storage.application",
        "net.gencat.transversal.espaidoc.storage.infrastructure"
})
@EnableMongoRepositories(basePackages = "net.gencat.transversal.espaidoc.storage.infrastructure")
@EnableScheduling
public class FrontofficeApplication {
}

这种方式下，Spring会自动扫描指定包下的@Configuration类，并加载其中注册的Bean，无需额外过滤规则，配置更清晰易维护。

内容的提问来源于stack exchange，提问作者Jordi