解决 IDEA 中 Lombok 编译报错：JDK 版本配置完整指南

问题背景

在 IntelliJ IDEA 开发 Java 项目时，经常会遇到 Lombok 注解处理器无法识别符号的编译错误。这通常不是代码逻辑问题，而是 JDK 版本与 Lombok 插件版本不匹配导致的。很多教程只提到了修改一处配置，导致实际运行时环境依然不一致。

经过验证，Lombok 1.18.30 和 1.18.38 版本均可正常编译，但为了兼容性建议更新到最新稳定版。以下是从依赖管理到 IDE 设置的全流程解决方案。

1. 升级 Lombok 依赖

首先检查项目根目录下的 pom.xml 文件，确保 Lombok 的版本已更新。建议直接使用最新版本以获取更好的支持。

2. 配置 JDK 环境

下载 JDK

推荐使用 JDK 17 或 JDK 21，这两个版本在 Spring Boot 项目中兼容性较好。JDK 23 可能存在兼容性问题，暂不建议使用。

建议将不同版本的 JDK 统一安装在同一目录下，方便后续管理和切换。

环境变量设置

安装完成后，需要配置系统环境变量 JAVA_HOME 指向新的 JDK 路径。这一步是基础，确保命令行能调用正确的编译器。

3. IDEA 项目设置

仅仅配置了环境变量还不够，IDEA 内部的项目结构设置也必须同步更新。

项目结构 (Project Structure)

打开 File > Project Structure，依次检查以下三个关键位置：

1. Project SDK：确保这里选择的是你刚安装的 JDK 17 或 21。
2. Project Language Level：语言级别应与 SDK 版本保持一致。
3. Modules：模块层面的 SDK 设置也需确认无误。

Maven 编译器设置

这是最容易被忽略的一步。Maven 有自己的编译器配置，如果这里没改，构建时依然会报错。

进入 Settings > Build, Execution, Deployment > Compiler > Java Compiler，确保目标字节码版本与 JDK 一致。

4. 验证结果

完成上述所有步骤后，重新构建项目（Rebuild Project）。如果一切配置正确，之前的'找不到符号'报错应该已经消失，Lombok 注解也能正常生成 getter/setter 等方法。