使用Lombok生成方法时src/main目录出现方法未定义问题

问题现象 #

• 在src/main/java目录的类中调用Lombok生成的方法（如getRuleType()）时，IDE提示The method getRuleType() is undefined for the type RuleFormat错误
• 手动编写对应方法则无任何报错
• 在src/test/java目录的测试类中调用同一Lombok生成的方法完全正常，执行mvn clean test; mvn clean install编译、测试、打包均无问题
• 已尝试：按Lombok官方指南配置Maven、调整pom依赖scope、重装VS Code的Lombok插件，但问题仍未解决

核心原因 #

这类问题几乎都是IDE的Lombok注解处理范围未覆盖main目录，或是IDE的项目缓存、编译配置异常导致的（因为Maven编译正常，说明Lombok在构建层面是生效的）。

针对VS Code的解决步骤 #

1. 检查并修正VS Code的Lombok相关配置
   打开设置（快捷键Ctrl+,），搜索lombok，确保以下配置已开启：

   "java.compile.nullAnalysis.mode": "automatic",
   "lombok.config.enabled": true,
   "java.configuration.updateBuildConfiguration": "automatic"
   

   也可直接在项目根目录的.vscode/settings.json中手动添加上述配置。

2. 强制刷新Java语言服务器缓存

   • 打开命令面板（快捷键Ctrl+Shift+P）
   • 输入并执行Java: Clean Java Language Server Workspace，随后重启VS Code
   • 重启后等待项目重新索引完成，再检查报错是否消失

3. 校验项目的.classpath配置
   确保项目根目录的.classpath文件中，Lombok依赖的条目包含annotation-processing属性，示例如下：

   <classpathentry kind="lib" path="~/.m2/repository/org/projectlombok/lombok/1.18.30/lombok-1.18.30.jar">
       <attributes>
           <attribute name="annotation-processing" value="true"/>
       </attributes>
   </classpathentry>
   

   若缺少该配置，手动添加后再次执行上述缓存清理操作。

4. 检查实体类的Lombok注解
   确认RuleFormat类上的Lombok注解（如@Data、@Getter、@Setter）未写错，且未误加@TestOnly这类仅测试环境生效的注解。

通用排查方案（适用于所有IDE） #

• 确认Lombok依赖及编译插件配置
  pom.xml中Lombok依赖的scope必须为compile，同时maven-compiler-plugin需配置注解处理器：

  <dependency>
      <groupId>org.projectlombok</groupId>
      <artifactId>lombok</artifactId>
      <version>1.18.30</version>
      <scope>compile</scope>
  </dependency>
  
  <build>
      <plugins>
          <plugin>
              <groupId>org.apache.maven.plugins</groupId>
              <artifactId>maven-compiler-plugin</artifactId>
              <version>3.8.1</version>
              <configuration>
                  <source>1.8</source>
                  <target>1.8</target>
                  <annotationProcessorPaths>
                      <path>
                          <groupId>org.projectlombok</groupId>
                          <artifactId>lombok</artifactId>
                          <version>1.18.30</version>
                      </path>
                  </annotationProcessorPaths>
              </configuration>
          </plugin>
      </plugins>
  </build>
  

• 清理项目编译产物后重新构建
  手动删除项目根目录的target文件夹，再执行mvn clean install，之后让IDE重新同步项目。

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