Spring Boot 3 废弃了 spring.factories，必须改用 META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports 文件声明自动配置类，并推荐使用 @AutoConfiguration 替代 @Configuration 以保障加载顺序与条件化行为。
spring boot 3 废弃了 `spring.factories`，必须改用 `meta-inf/spring/org.springframework.boot.autoconfigure.autoconfiguration.imports` 文件声明自动配置类，并推荐使用 `@autoconfiguration` 替代 `@configuration` 以保障加载顺序与条件化行为。
在 Spring Boot 3.x（如 3.0.5）中，自定义 Starter 库的自动配置机制发生了重大变更：META-INF/spring.factories 文件已完全弃用，不再支持 org.springframework.boot.autoconfigure.EnableAutoConfiguration 键的自动配置注册。若继续沿用该方式，Spring Boot 将静默忽略你的配置类，导致 HelloService 等 Bean 无法被扫描和实例化，最终引发典型的 NoSuchBeanDefinitionException（如控制器注入失败）。
✅ 正确做法：使用 AutoConfiguration.imports 文件
你需要在库模块（spring-lib）的 src/main/resources/META-INF/spring/ 目录下创建文件：
org.springframework.boot.autoconfigure.AutoConfiguration.imports
⚠️ 注意路径和文件名必须完全一致（大小写敏感），且位于 resources 下，而非 java 源码目录。
文件内容为纯文本，每行一个全限定类名，例如：
com.example.springlib.configuration.HelloConfiguration
如果后续扩展多个配置类，可追加多行：
com.example.springlib.configuration.HelloConfiguration com.example.springlib.configuration.DatabaseConfiguration
✅ 推荐升级：使用 @AutoConfiguration 替代 @Configuration
虽然 @Configuration 在技术上仍可工作，但 Spring Boot 官方强烈建议在自动配置场景中使用 @AutoConfiguration —— 它隐式具备 @Configuration 语义，并原生支持 @ConditionalOnClass、@ConditionalOnMissingBean 等条件注解，且能参与 Spring Boot 的自动配置排序机制（如 @AutoConfigureBefore / @AutoConfigureAfter）。
修改你的配置类如下：
package com.example.springlib.configuration;
import org.springframework.boot.autoconfigure.AutoConfiguration;
import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.context.annotation.Bean;
@AutoConfiguration
@ConfigurationProperties(prefix = "com.example.hello")
public class HelloConfiguration {
private String text;
// 必须提供 setter 或使用 @ConstructorBinding（推荐用于不可变配置）
public void setText(String text) {
this.text = text;
}
@Bean
@ConditionalOnMissingBean
public HelloService helloService() {
return new HelloService(text);
}
}? 补充说明：@ConfigurationProperties 类本身不应直接标注 @Bean（它不是组件），而是由 Spring Boot 的 ConfigurationPropertiesBinder 绑定。因此需确保 text 字段有 setter，或改用构造器绑定（需添加 @ConstructorBinding 并将类设为 static 内部类或配合 @EnableConfigurationProperties）。
✅ 验证与注意事项
- 依赖传递性：确保 Web 应用模块正确声明对 spring-lib 的 implementation（Gradle）或 compile（Maven）依赖，且 spring-lib 的 JAR 包中确实包含 META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports 文件（可通过解压 JAR 验证）。
- 包扫描范围：@AutoConfiguration 类无需被主应用 @ComponentScan 扫描，它由 Spring Boot 的自动配置基础设施独立加载。
- 配置属性前缀：application.yml 中的 com.example.hello.text 能正确绑定，前提是 HelloConfiguration 类成功加载并完成属性绑定。
- IDE 支持：IntelliJ IDEA 和 Spring Tools 4 已支持 AutoConfiguration.imports 语法高亮与导航；如未识别，请刷新 Maven/Gradle 项目并检查资源目录是否被标记为 “Resources Root”。
✅ 最终效果
完成上述修改后，启动 Web 应用，调用 GET /hello/Bob 即可返回：
{ "message": "Hello Bob!" }这表明 HelloConfiguration 已被 Spring Boot 自动发现、属性成功绑定、HelloService Bean 正确注册并注入到控制器中。
总结：Spring Boot 3 的自动配置迁移是强制性的基础改造，核心在于替换配置文件路径 + 升级注解语义。遵循官方约定，不仅能解决当前问题，更能确保库的可维护性与未来兼容性。
