Spring Boot 3.4.0无法自动识别生成代码中的AutoConfiguration

核心原因 #

Spring Boot 2.7+（含3.4.0）不再依赖spring.factories注册自动配置类，转而采用META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports文件作为新的注册入口。你的问题大概率是生成的注册文件未被正确打包到类路径，或者格式不符合要求。

具体解决方案 #

1. 确认自动配置注册文件的格式与路径 #

• 生成的文件必须位于target/generated-sources/demo-client/META-INF/spring/下，文件名严格为org.springframework.boot.autoconfigure.AutoConfiguration.imports
• 文件内容需每行一个AutoConfiguration类的全限定名，示例：

  com.yourpackage.demo.client.DemoApiClientAutoConfiguration
  

• 检查是否存在拼写错误（包名、类名），或多余的空格/换行符

2. 将生成目录标记为源码目录 #

Maven/Gradle需要把target/generated-sources/demo-client识别为源码目录，否则里面的类和资源文件（包括META-INF配置）不会被打包到最终产物中：

Maven配置（pom.xml）

<build>
    <plugins>
        <plugin>
            <groupId>org.codehaus.mojo</groupId>
            <artifactId>build-helper-maven-plugin</artifactId>
            <version>3.4.0</version>
            <executions>
                <execution>
                    <id>add-generated-sources</id>
                    <phase>generate-sources</phase>
                    <goals>
                        <goal>add-source</goal>
                    </goals>
                    <configuration>
                        <sources>
                            <source>target/generated-sources/demo-client</source>
                        </sources>
                    </configuration>
                </execution>
                <execution>
                    <id>add-generated-resources</id>
                    <phase>generate-resources</phase>
                    <goals>
                        <goal>add-resource</goal>
                    </goals>
                    <configuration>
                        <resources>
                            <resource>
                                <directory>target/generated-sources/demo-client</directory>
                                <includes>
                                    <include>META-INF/**/*</include>
                                </includes>
                            </resource>
                        </resources>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

Gradle配置（build.gradle）

sourceSets {
    main {
        java {
            srcDirs += 'target/generated-sources/demo-client'
        }
        resources {
            srcDirs += 'target/generated-sources/demo-client'
            include 'META-INF/**/*'
        }
    }
}

3. 验证AutoConfiguration类的注解正确性 #

• 确保DemoApiClientAutoConfiguration类上标注了@Configuration注解
• 检查条件注解（如@ConditionalOnClass、@ConditionalOnProperty）的逻辑是否符合预期，例如使用@ConditionalOnProperty时，确认启动环境满足该条件（默认值设置是否合理）

4. 验证打包后的类路径 #

• 打包后解压生成的jar包，查看BOOT-INF/classes/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports是否存在且内容正确
• 开发环境中，在IDE项目结构里确认target/generated-sources/demo-client已被标记为源码/资源目录

5. 检查OpenAPI Generator模板 #

如果是自定义模板生成这些文件：

• 确认模板中生成的注册文件路径完全正确
• 确保模板输出的类全限定名与实际生成的DemoApiClientAutoConfiguration类的包名、类名一致，无硬编码错误

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