Spring Boot构建报错：无处理器识别指定注解（含-Werror配置）

问题原因 #

启用-Xlint:all会开启所有编译警告，其中包含processing类别警告：当编译器发现某些注解没有对应的编译时处理器认领时，会抛出警告。而-Werror将所有警告强制转为错误，直接导致构建失败。

报错中的注解分为两类：

• Jakarta Validation校验注解（如@NotBlank、@Email）
• Jackson运行时注解（如@JsonInclude）
  其中Jackson注解属于运行时生效类型，不需要编译时处理器；而Validation注解若未引入编译时处理器，也会触发该警告。

解决方案 #

方案一：排除特定警告（推荐，快速解决） #

修改Gradle配置，关闭“未被处理器认领的注解”相关警告，避免被-Werror转为错误：

tasks.withType<JavaCompile> {
    options.encoding = "UTF-8"
    options.compilerArgs.add("-Xlint:all")
    options.compilerArgs.add("-Xlint:-processing") // 关闭processing类警告
    options.compilerArgs.add("-Werror")
}

方案二：引入对应注解处理器（如需编译时校验） #

如果需要保留编译时注解检查（比如Validation的静态校验），需引入对应的注解处理器依赖：

1. Jakarta Validation注解处理器
   在build.gradle中添加注解处理器依赖：

dependencies {
    // 基础Validation依赖（若已引入可忽略）
    implementation 'org.springframework.boot:spring-boot-starter-validation'
    // 引入Validation编译时处理器
    annotationProcessor 'org.hibernate.validator:hibernate-validator-annotation-processor'
}

2. Jackson注解（可选）
   Jackson注解为运行时生效，通常不需要编译时处理器。若仍有警告，可添加Jackson的注解处理器依赖：

dependencies {
    annotationProcessor 'com.fasterxml.jackson.core:jackson-databind'
}

注意：Spring Boot 3.x版本依赖基于Jakarta EE，所有相关注解均为jakarta.validation包下，无需切换为旧的javax.validation依赖。

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