Spring Boot自动配置完全依赖META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports文件显式声明，未列入该文件的@AutoConfiguration类不会被加载；该文件每行一个全限定类名，删改会导致启动时抛IllegalStateException并中断，且无fallback机制。
Spring Boot自动配置中元数据（META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports）是决定哪些配置类被加载的关键清单，新手常误以为自动配置是“自动扫描”出来的，其实它完全依赖这个文件显式声明——没有写进这个文件的配置类，哪怕加了@AutoConfiguration注解也不会生效。
元数据文件长什么样
打开任意一个 Spring Boot Starter 的 jar 包（比如 spring-boot-starter-web），在 META-INF/spring/ 目录下找到 org.springframework.boot.autoconfigure.AutoConfiguration.imports 文件，里面内容就是纯文本，每行一个全限定类名：
org.springframework.boot.autoconfigure.web.servlet.DispatcherServletAutoConfiguration
org.springframework.boot.autoconfigure.web.servlet.ServletWebServerFactoryAutoConfiguration
org.springframework.boot.autoconfigure.web.servlet.WebMvcAutoConfiguration
这三行不是示例，而是真实存在的——Spring Boot 启动时只认这个文件里列出的类，其他类哪怕放在 classpath 下、带 @AutoConfiguration 注解，也根本不会被加载。
为什么不能删掉或手改这个文件
直接编辑这个文件会立刻导致启动失败：Spring Boot 读取该文件后，会对每一行做类加载校验，如果某行类名拼错、类不存在、或类没有 @AutoConfiguration 注解，整个应用会在 SpringApplication.run() 阶段抛出 IllegalStateException 并中断启动。
【删改后无法恢复默认行为】 这个文件一旦被破坏，Spring Boot 不会尝试“智能修复”，也不会 fallback 到旧版 spring.factories，而是直接报错退出。
新手怎么验证元数据是否生效
方法一：用 IDE 反编译查看 starter jar 中的 imports 文件 → 确认你要用的自动配置类确实在列表里；
将 Spring Boot 2.7 项目升级到 Spring Boot 3.5 的实战流程，覆盖版本基线、依赖坐标替换、Jakarta 迁移、配置兼容、异步上下文传递改造与验证门禁。用于企业多模块 Maven 项目升级与排障。
方法二：启动时加 JVM 参数 -Ddebug → 控制台会打印所有被加载的自动配置类及其匹配条件（例如 “matched: @ConditionalOnClass found required class ‘javax.servlet.Servlet’”）；
方法三：在 application.properties 中设 debug=true → 日志里搜索 “AutoConfigurationReport”，能看到完整匹配报告，包括哪些类因条件不满足被跳过。
自定义 Starter 必须写元数据
第一步：在你自己的 starter 模块的 src/main/resources/META-INF/spring/ 目录下创建 org.springframework.boot.autoconfigure.AutoConfiguration.imports 文件；
第二步：把你的自动配置类全限定名写进去，一行一个，不能有空行、不能有中文、不能有注释；
第三步：确保该类上有 @AutoConfiguration 注解，且类路径必须能被 Spring Boot 扫描到（通常放在 starter 的 jar 包根路径下）；
第四步：在使用该 starter 的主应用中引入依赖 → 启动时就会自动加载你写的配置类。这一步漏掉任何一项，你的自定义配置就等于没写。
