IntelliJ中Gradle无法识别Lombok@Log4j2生成的log字段问题

Gradle项目编译时，Lombok的@Log4j2生成的log变量、@Data生成的setData方法均提示“cannot find symbol”，且已有常规方案无效，可尝试以下解决步骤：

1. 统一Lombok依赖版本 #

避免编译与测试阶段使用不同版本的Lombok，版本不一致会引发注解处理逻辑冲突。修改build.gradle，确保所有Lombok依赖版本统一：

compileOnly 'org.projectlombok:lombok:1.18.22'
annotationProcessor 'org.projectlombok:lombok:1.18.22'
testCompileOnly 'org.projectlombok:lombok:1.18.22'
testAnnotationProcessor 'org.projectlombok:lombok:1.18.22'

2. 使用Lombok Gradle插件简化配置 #

手动配置依赖易出错，推荐使用io.freefair.lombok插件自动管理Lombok的依赖与注解处理器：

plugins {
    id 'java'
    id 'io.freefair.lombok' version '8.6' // 版本可根据Gradle版本调整
}

添加插件后，可删除手动配置的Lombok依赖，插件会自动完成配置。

3. 清理Gradle缓存并重新构建 #

旧缓存可能导致依赖加载异常，执行以下命令清理缓存并强制重新构建：

./gradlew clean build --refresh-dependencies

4. 检查Gradle版本兼容性 #

旧版Gradle（如6.x及以下）与新版Lombok存在兼容性问题，建议将Gradle升级至7.x或8.x稳定版。可修改gradle/wrapper/gradle-wrapper.properties中的distributionUrl完成升级：

distributionUrl=https\://services.gradle.org/distributions/gradle-8.5-bin.zip

5. 修复项目编码问题 #

错误日志中的乱码可能导致Lombok注解处理失败，在build.gradle中添加编码配置：

tasks.withType(JavaCompile) {
    options.encoding = 'UTF-8'
}

同时在IDE设置中（如IntelliJ的File > Settings > Editor > File Encodings）将所有编码选项设置为UTF-8。

6. 验证IDE注解处理器配置 #

除开启Preferences > Compiler > Annotation Processors外，需确保：

• IDE的Lombok插件已启用（可在插件市场搜索确认）
• 项目结构中，Lombok依赖被正确标记为注解处理器

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