Spring Boot多模块自动装配失效的根本原因在于路径、条件、扫描或版本适配问题；需确保META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports路径正确、条件注解满足、包扫描覆盖、依赖传递无冲突。
多模块项目中Spring Boot自动装配不生效，表现为跨模块的@AutoConfiguration类未加载、Bean缺失、切面未触发、跨域配置无效等现象，根本原因常藏在路径、条件、扫描或版本适配环节。
确认自动配置文件路径是否正确
Spring Boot 3.x起，自动配置不再读取META-INF/spring.factories，而是强制要求使用META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports文件，且路径必须严格匹配。
第一步：进入模块A（提供配置的模块）的src/main/resources目录下，手动创建完整路径：【META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports】。
注意：IDEA中若显示为META-INF.spring（带点而非斜杠），说明文件夹被误识别为包名——这是Windows/macOS文件系统对点号路径的常见误判，需右键→“Reload project”或重启IDEA，确保该路径在编译后真实存在于target/classes/META-INF/spring/下。
第二步：在imports文件中，每行写一个自动配置类的全限定名，不可有多余空格或BOM头：
com.example.moduleA.config.IdempotentAutoConfiguration
com.example.moduleA.config.ResourcesConfig
验证自动配置类是否被Spring Boot识别
方法一：启动时加JVM参数查看候选配置列表
-Ddebug=true → 启动后控制台会输出“Automatically configured classes”，从中搜索你的配置类名。若未出现，说明未被发现。
方法二：在自动配置类的静态块中打印日志
在IdempotentAutoConfiguration类顶部添加：
static { System.out.println("✅ IdempotentAutoConfiguration loaded"); }
若控制台无此输出，证明该类未被ClassLoader加载，问题一定出在路径、依赖或条件注解上。
检查条件注解是否满足
@ConditionalOnClass、@ConditionalOnWebApplication等注解是“开关”，不满足则直接跳过整个配置类。
打开你的自动配置类，重点检查：
@ConditionalOnClass({RedisTemplate.class}) → 确保模块B已引入spring-boot-starter-data-redis，否则该配置类不会加载。
@ConditionalOnWebApplication(type = Type.SERVLET) → 若模块B是WebFlux项目，此条件不成立，配置失效。
@ConditionalOnProperty(name = "modulea.enabled", havingValue = "true", matchIfMissing = true) → 检查application.yml中是否误写了modulea.enable（少个d），导致属性未命中。
强制启用包扫描与手动导入
当模块B的启动类包路径无法覆盖模块A的配置类时，自动扫描失败。
第一步：在模块B的@SpringBootApplication注解中显式声明扫描路径
@SpringBootApplication(scanBasePackages = {"com.example.moduleB", "com.example.moduleA"})
第二步：若仍不生效，临时用@Import兜底验证
@SpringBootApplication
@Import({IdempotentAutoConfiguration.class, ResourcesConfig.class})
这一步能绕过所有自动装配机制，直接注入配置类。如果此时功能正常，说明问题100%出在自动装配链路（imports路径/条件/依赖），而非代码逻辑本身。
排查依赖传递与版本冲突
模块B通过
检查模块A的pom.xml，确保没有以下危险配置：
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-autoconfigure</artifactId>
<scope>provided</scope> <!-- ⚠️ 删除这一行 -->
</dependency>
同时运行mvn dependency:tree -Dverbose | grep autoconfigure，确认spring-boot-autoconfigure实际被模块B间接依赖，且版本统一（Spring Boot 3.3.x需匹配spring-boot-autoconfigure 3.3.x）。
