Kotlin+Spring Boot 2.0：@ConfigurationProperties问题及元数据生成方案

我来帮你排查这个让@ConfigurationProperties无法生成spring-configuration-metadata.json的问题，结合Spring Boot 2和Kotlin的特性，咱们一步步来解决：

1. 确认Maven依赖与注解处理器配置 #

首先得确保编译期注解处理器的依赖和配置都到位，这是生成元数据的核心：

• 必须添加spring-boot-configuration-processor依赖，而且要设为optional，避免打包到运行时：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-configuration-processor</artifactId>
    <optional>true</optional>
</dependency>

• 对于Kotlin项目，还要在kotlin-maven-plugin里配置注解处理器，让它能识别Spring的注解处理器：

<plugin>
    <groupId>org.jetbrains.kotlin</groupId>
    <artifactId>kotlin-maven-plugin</artifactId>
    <configuration>
        <args>
            <arg>-Xjsr305=strict</arg>
        </args>
        <compilerPlugins>
            <plugin>spring</plugin>
        </compilerPlugins>
        <annotationProcessorPaths>
            <path>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-configuration-processor</artifactId>
                <version>${spring-boot.version}</version>
            </path>
        </annotationProcessorPaths>
    </configuration>
    <dependencies>
        <dependency>
            <groupId>org.jetbrains.kotlin</groupId>
            <artifactId>kotlin-maven-allopen</artifactId>
            <version>${kotlin.version}</version>
        </dependency>
    </dependencies>
</plugin>

这里的kotlin-maven-allopen插件很关键——Kotlin默认类是final的，Spring无法生成代理类，这个插件会自动把Spring相关注解标注的类改成open。

2. 检查@ConfigurationProperties类的注解正确性 #

你的LogDbProperties.kt需要满足几个条件：

• 类上必须有@ConfigurationProperties，并且指定配置前缀（比如prefix = "log.db"）
• 要么类上添加@Configuration，要么在启动类用@EnableConfigurationProperties(LogDbProperties::class)来启用这个配置类
• 确保类是可继承的（要么手动加open关键字，要么用上面的allopen插件自动处理）

正确的示例：

@ConfigurationProperties(prefix = "log.db")
@Configuration // 或者用启动类的@EnableConfigurationProperties替代
open class LogDbProperties {
    var url: String? = null
    var username: String? = null
    var password: String? = null
}

3. 强制触发元数据生成并检查IntelliJ设置 #

• 先手动执行Maven命令强制编译：mvn clean compile，看看target/classes/META-INF下有没有生成spring-configuration-metadata.json
• 检查IntelliJ的注解处理器设置：打开File → Settings → Build, Execution, Deployment → Compiler → Annotation Processors，确保Enable annotation processing选项是勾选的，并且处理器路径包含了spring-boot-configuration-processor
• 如果还是不行，试试重新导入Maven项目：右键项目 → Maven → Reload Project

4. 确认Spring Boot与Kotlin版本兼容性 #

Spring Boot 2.x对Kotlin版本有明确的兼容要求，比如：

• Spring Boot 2.7.x 对应 Kotlin 1.6.x
• Spring Boot 2.6.x 对应 Kotlin 1.5.x
  如果版本不匹配，可能会导致注解处理器无法正常工作，检查你的pom.xml里的版本是否对应。

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