升级Java 10至11、Gradle 4.10至5.2后遇Lombok变量未初始化错误

这个问题我之前也碰到过，核心原因是Gradle 5.x对注解处理器的处理逻辑发生了变化——它不再像旧版本那样自动识别并启用Lombok这类注解处理器，导致Lombok没能生成@Value和@Builder对应的构造器、Builder代码。最终编译器看到final字段没有被初始化，就抛出了错误。哪怕你升级了Lombok版本，如果Gradle配置没跟上，问题依然会存在。

下面是具体的解决步骤：

1. 正确配置Lombok作为注解处理器 #

在你的build.gradle中，需要同时声明compileOnly和annotationProcessor依赖，明确告诉Gradle要把Lombok当作注解处理器来使用：

dependencies {
    // 仅编译时依赖Lombok，不打包到产物中
    compileOnly 'org.projectlombok:lombok:1.18.6'
    // 明确指定Lombok为注解处理器
    annotationProcessor 'org.projectlombok:lombok:1.18.6'
    
    // 你的其他业务依赖...
}

如果是多模块项目，要确保每个用到Lombok的子模块都添加上述配置。

2. 明确Java版本兼容性 #

在build.gradle中显式设置Java 11的编译和目标兼容性，避免Gradle默认使用旧版本的编译规则：

java {
    sourceCompatibility = JavaVersion.VERSION_11
    targetCompatibility = JavaVersion.VERSION_11
}

3. 强制绑定注解处理器路径（可选但推荐） #

部分场景下，Gradle可能没有自动关联注解处理器的依赖路径，你可以显式配置编译任务来确保：

tasks.withType(JavaCompile) {
    options.annotationProcessorPath = configurations.annotationProcessor
}

4. 清理缓存并重新构建 #

执行以下命令清理Gradle缓存和旧构建产物，避免缓存干扰新配置的生效：

./gradlew clean build --refresh-dependencies

额外排查点（如果上述步骤无效） #

• 检查IDE的Lombok插件是否启用（比如IntelliJ IDEA需要安装Lombok插件，并在设置中开启"Enable annotation processing"选项）
• 尝试升级Lombok到更稳定的版本，比如1.18.20（1.18.6已支持Java 11，但新版本可能修复了一些小兼容性问题）
• 确认Gradle 5.2的Java环境配置正确，执行./gradlew -v检查输出的Java版本是否为11

按照这些步骤操作后，Lombok应该能正常生成所需的构造器和Builder代码，编译错误就会消失。

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