Spring Boot 3.X.X无法识别自定义Maven日志库中的配置类

算力阿峰

2026-6-28

解决Spring Boot 3.x中自定义Maven日志库配置类不被识别的问题

问题根源

Spring Boot 3.x 基于Spring Framework 6重构了自动配置加载逻辑：2.x版本中@ComponentScan会自动扫描第三方Jar包内的@Configuration类，但3.x默认仅扫描启动类所在包及其子包，第三方Jar包的配置类必须显式声明才能被容器加载。

解决方案

1. 升级配置类为自动配置类（推荐）

将日志库中的@Configuration替换为Spring Boot 3.x专属的@AutoConfiguration注解，这是官方推荐的第三方配置类声明方式：

package com.abc.xyz.logging;

import org.springframework.boot.autoconfigure.AutoConfiguration;
import org.springframework.context.annotation.Bean;

@AutoConfiguration
public class LoggingConfiguration {
    @Bean
    public LoggingBean getLoggingBean() { // 修复原代码拼写错误：getLogginBean -> getLoggingBean
        return new LoggingBean();
    }
}

2. 注册自动配置类

在日志库的src/main/resources/META-INF/spring/目录下，创建名为org.springframework.boot.autoconfigure.AutoConfiguration.imports的文件，写入配置类的全限定名：

com.abc.xyz.logging.LoggingConfiguration

该文件会告知Spring Boot启动时主动加载这个配置类。

3. 备选方案：在应用端显式扫描包路径

如果无法修改日志库代码，可在应用启动类的@SpringBootApplication中添加包扫描范围，包含日志库的包：

package com.abc.xyz.sample;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication(scanBasePackages = {"com.abc.xyz.sample", "com.abc.xyz.logging"})
public class ExampleConsumerApp {

    public static void main(String[] args) {
        SpringApplication.run(ExampleConsumerApp.class, args);
    }
}

此方案耦合性较高，仅作为临时替代方案使用。