Spring库中@Configuration无法读取主应用application.yaml属性求助

1. 正确使用配置属性绑定注解 #

库中的@Configuration类必须通过注解明确绑定主应用的配置属性，不能依赖自动读取：

• 推荐使用@ConfigurationProperties批量绑定属性，指定前缀后，Spring会自动匹配主应用yaml中对应前缀的属性。示例代码：

@Configuration
@ConfigurationProperties(prefix = "my-lib")
public class MyLibConfig {
    // 定义需要绑定的属性
    private String apiUrl;
    private int timeout;

    // 必须提供getter和setter方法，Spring通过setter注入属性
    public String getApiUrl() {
        return apiUrl;
    }

    public void setApiUrl(String apiUrl) {
        this.apiUrl = apiUrl;
    }

    public int getTimeout() {
        return timeout;
    }

    public void setTimeout(int timeout) {
        this.timeout = timeout;
    }
}

• 如果用@Value绑定单个属性，要确保属性键完全匹配，比如@Value("${my-lib.api-url}") private String apiUrl;

2. 确保库的配置类被主应用加载 #

主应用必须能扫描到库中的配置类，两种可行方式：

• 方式一：主应用主动扫描
  在主应用启动类上添加@ComponentScan，指定库的包路径：

@SpringBootApplication
@ComponentScan(basePackages = {"com.your.main.app", "com.your.lib.package"})
public class MainApplication {
    public static void main(String[] args) {
        SpringApplication.run(MainApplication.class, args);
    }
}

• 方式二：库自动配置（推荐）
  在库的src/main/resources/META-INF/spring目录下创建org.springframework.boot.autoconfigure.AutoConfiguration.imports文件，写入配置类的全限定名：

com.your.lib.package.MyLibConfig

主应用引入库后，Spring Boot会自动加载该配置类，无需主应用额外配置。

3. 主应用yaml配置匹配属性键 #

主应用的application.yaml中要配置与库绑定前缀一致的属性，示例：

my-lib:
  api-url: "https://example.com/api"
  timeout: 3000

注意：Java类中的驼峰命名（如apiUrl）在yaml中可以用短横线分隔（api-url）或保持驼峰，Spring会自动映射。

4. 主应用覆盖库默认配置的实现 #

如果需要主应用配置覆盖库自带的默认配置：

1. 在库中添加自己的application.yaml，写入默认属性；
2. 主应用的application.yaml中配置相同键的属性即可，Spring Boot默认优先级是：外部应用配置 > jar包内配置，会自动覆盖。

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