Idea-Spring-boot 项目启动无法识别lombok

文章目录

  • 前言
  • [一、lombok 是什么?](#一、lombok 是什么?)
  • [二、lombok 启动无法识别](#二、lombok 启动无法识别)
    • [2.1 原因:](#2.1 原因:)
    • [2.2 处理步骤](#2.2 处理步骤)
  • 总结

前言

项目中使用lombok 隐藏式的生成get,set ,tostring 等方法,项目编译成功,但是启动时报错无法识别lombok 组件中的 builder()。


一、lombok 是什么?

Lombok 是一个Java 库(工具类),核心作用是:通过注解替代 Java 类中重复、冗余的模板代码(如 Getter/Setter、构造器、toString、日志声明等),让代码更简洁,开发效率更高。

二、lombok 启动无法识别

Spring Boot 项目 maven install 编译成功,但启动时 Lombok 的 builder() 提示「找不到符号」,核心原因是编译阶段(Maven)和运行 / IDE 启动阶段的 Lombok 处理不一致------Maven 编译时触发了 Lombok 生成 builder() 方法,但 IDE 运行时未识别该生成代码,或运行时类加载路径缺失 Lombok 生成的字节码。

2.1 原因:

maven install 成功说明:

Maven 编译时已通过「注解处理器」触发 Lombok 生成 builder() 方法,字节码文件(class)中存在该方法;

启动时报错说明:

IDE 直接运行项目时,未启用 Lombok 注解处理,导致编辑器 / 运行时无法识别 builder()(仅识别源码,未识别 Lombok 生成的字节码);

或 IDE 运行时的类路径与 Maven 编译后的类路径不一致,加载了未生成 builder() 的源码版本。

2.2 处理步骤

步骤1: 重新编译文件,并验证 class 文件:

打开项目 target/classes/ 下对应类的 class 文件(可通过 IDEA 反编译查看),确认是否有 builder() 方法:

复制代码
若有 → 说明编译成功,仅 IDE 运行时未加载;
若无 → 回到步骤 2 检查 Maven 注解处理器配置。

步骤 2:检查 IDEA 关键配置(核心!)

IDEA 未启用 Lombok 插件或注解处理,是启动时识别不到 builder() 的最常见原因:

2.1 确认 Lombok 插件已安装并启用

复制代码
IDEA → Settings → Plugins → 搜索「Lombok」→ 确保插件已安装且「Enabled」(勾选);
若插件未安装,直接在插件市场安装后重启 IDEA(必须重启!)。

2.2 开启注解处理器(强制 IDE 识别 Lombok 生成代码)

复制代码
IDEA → Settings → Build, Execution, Deployment → Compiler → Annotation Processors;
勾选「Enable annotation processing」(启用注解处理);
勾选「Obtain processors from project classpath」(从项目类路径获取注解处理器);
点击「Apply」→「OK」,重启 IDEA。

总结

本文记录Idea-Spring-boot 项目启动无法识别lombok。

相关推荐
摇滚侠27 分钟前
《On Java 中文版 基础卷》阅读笔记 接口 18
java·笔记·python
CoderYanger1 小时前
Java EE 进阶:9.MyBatis 操作数据库(进阶)(第八弹):MyBatis Generator
java·数据库·spring boot·spring·java-ee·tomcat·mybatis
jaysee-sjc4 小时前
【黑马点评】Day02:优惠券秒杀与分布式锁
java·分布式·nginx·spring·node.js·tomcat·maven
秋天的怀念_David4 小时前
算法一千零一夜 · 第三十五夜 · 恢复风暴
java·程序人生·算法
考虑考虑4 小时前
JDK27中的加密对象的 PEM 编码
java·后端·java ee
行者-全栈开发5 小时前
SpringBoot + GraalVM 原生编译实战:启动时间从8秒到0.5秒的极致优化
java·spring boot·后端
CoderYanger5 小时前
Java EE 进阶:10. MyBatis-Plus使用(第一弹)
java·spring boot·后端·sql·spring·java-ee·mybatis
大胖爱学习_MJ7 小时前
超越向量检索:用 Spring Boot + Neo4j 手搓 GraphRAG 知识图谱记忆
java·后端·python
吃我一窝jio7 小时前
Java博客极简写作三支柱
java
知识搬运临时工8 小时前
双路服务器跑得比单路慢:JVM 没看见内存的距离
java·后端