Eclipse中spring-boot-configuration-processor无法生成元数据求助

以下是针对你遇到的spring-boot-configuration-processor未生成元数据文件问题的排查和解决步骤：

1. 确认依赖配置正确性 #

首先检查项目构建文件（Maven/Gradle）中处理器依赖的配置是否正确：

Maven配置 #

确保依赖添加了<optional>true</optional>，避免传递依赖：

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

Gradle配置 #

需要同时声明annotationProcessor和compileOnly依赖：

annotationProcessor 'org.springframework.boot:spring-boot-configuration-processor'
compileOnly 'org.springframework.boot:spring-boot-configuration-processor'

如果之前依赖配置错误，修正后执行一次完整的构建（mvn clean compile或gradle compileJava）。

2. 检查Eclipse注解处理器配置细节 #

即使你已经开启了注解处理，仍需确认以下细节：

• 右键项目 → Properties → Java Compiler → Annotation Processing，确保Enable annotation processing和Enable project specific settings都已勾选。
• 切换到Factory Path标签页，点击Add External JARs，找到本地仓库中spring-boot-configuration-processor的jar包添加进去，或者勾选Use dependencies from project classpath让Eclipse自动加载。
• 确认Java Compiler的版本与Spring Boot版本兼容（例如Spring Boot 3.x要求Java 17及以上）。

3. 验证Record类型的兼容性 #

虽然Spring Boot 2.2+支持用Record作为@ConfigurationProperties载体，但部分旧版本处理器对Record字段的识别可能存在问题。可以临时将Record替换为普通类测试：

package com.hakim.config;

import java.security.interfaces.RSAPrivateKey;
import java.security.interfaces.RSAPublicKey;
import org.springframework.boot.context.properties.ConfigurationProperties;

@ConfigurationProperties(prefix = "rsa")
public class RsaKeyProperties {
    private RSAPublicKey publicKey;
    private RSAPrivateKey privateKey;

    // 生成getter和setter
    public RSAPublicKey getPublicKey() { return publicKey; }
    public void setPublicKey(RSAPublicKey publicKey) { this.publicKey = publicKey; }
    public RSAPrivateKey getPrivateKey() { return privateKey; }
    public void setPrivateKey(RSAPrivateKey privateKey) { this.privateKey = privateKey; }
}

执行构建后检查是否生成元数据，若生成则说明原Record的处理存在兼容性问题，可升级Spring Boot版本至2.7+或更高版本解决。

4. 确保触发完整编译流程 #

注解处理器仅在编译阶段执行，因此不要只通过"Run Application"启动项目，需手动执行编译操作：

• Eclipse中右键项目 → Run As → Maven compile（或Gradle compile）
• 执行mvn clean compile命令，清理旧的target文件后重新编译

5. 检查元数据生成路径 #

默认元数据文件路径为target/classes/META-INF/spring-configuration-metadata.json，而非target根目录。确认你是否找错了路径。

6. 复杂类型的元数据生成问题 #

RSAPublicKey和RSAPrivateKey是接口类型，处理器可能无法自动识别并生成元数据。可以先临时替换为String类型测试：

@ConfigurationProperties(prefix = "rsa")
public record RsaKeyProperties(String publicKey, String privateKey) {}

若替换后能生成元数据，说明是复杂类型的问题。此时需要手动添加元数据文件，或实现Converter/GenericConverter来处理类型转换，同时可以在Record字段上添加@Description等注解辅助生成元数据。

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