Spring Boot自定义自动配置：target中缺失元数据文件问题排查

• 确认元数据文件的查找路径：生成的spring-configuration-metadata.json默认在target/classes/META-INF/下，而非target根目录的META-INF，先检查这个路径是否存在目标文件。
• 检查spring-boot-configuration-processor依赖配置：确保依赖未被误设为test范围，正确配置示例：

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

  optional=true可避免传递依赖给其他项目，不影响当前模块生成元数据。
• 验证Maven编译插件的注解处理器配置：如果父POM或当前模块的maven-compiler-plugin显式指定了annotationProcessors，必须包含org.springframework.boot.configurationprocessor.ConfigurationMetadataAnnotationProcessor；若使用annotationProcessorPaths，需确保包含processor依赖：

  <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-compiler-plugin</artifactId>
      <version>3.11.0</version>
      <configuration>
          <annotationProcessorPaths>
              <path>
                  <groupId>org.springframework.boot</groupId>
                  <artifactId>spring-boot-configuration-processor</artifactId>
                  <version>3.2.4</version>
              </path>
          </annotationProcessorPaths>
      </configuration>
  </plugin>
  

• 检查Maven编译命令执行情况：执行mvn clean compile而非仅依赖IDE自动编译，避免IDE缓存或编译逻辑差异导致文件未生成；同时确认未通过-Dmaven.compiler.skip=true等参数跳过编译。
• 排查父POM的干扰：检查父POM是否对maven-compiler-plugin或spring-boot-maven-plugin做了全局配置，比如排除注解处理器、修改输出目录等，导致子模块的processor无法正常工作。
• 确认属性类的注解完整性：虽然内部补全正常，仍需核对@ConfigurationProperties的prefix是否正确，且配置类是否被@ConfigurationPropertiesScan扫描到，或通过META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports文件注册（Spring Boot 2.7+推荐方式），确保processor能识别所有需要生成元数据的属性类。
• 检查Spring Boot Maven插件配置：确保插件版本与Spring Boot版本（3.2.4）一致，且未配置skip或其他抑制元数据生成的参数：

  <plugin>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-maven-plugin</artifactId>
      <version>3.2.4</version>
  </plugin>
  

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