测试类无法访问实体类Lombok特性的问题排查

核心问题 #

测试类无法调用Lombok生成的getter/setter、Builder等方法，根源在于Maven编译阶段未正确启用Lombok注解处理器，同时依赖配置存在不合理之处：

1. Lombok依赖的optional=true设置
   该配置会让Lombok依赖失去传递性，虽不影响主代码编译，但可能导致测试环境的注解处理环节无法正常加载Lombok。

2. 测试环境缺少Lombok注解处理支持
   若主代码编译时未生成Lombok方法，测试类自然无法调用；即便主代码编译正常，测试类编译阶段也需Lombok支持（比如测试类自身使用Lombok注解时）。

补充：spring-boot-maven-plugin中排除Lombok是合理操作（Lombok为编译时依赖，无需打包到最终产物），这不是导致问题的原因。

修复步骤 #

步骤1：调整Lombok依赖配置 #

修改pom.xml中的Lombok依赖，移除optional=true，添加provided作用域（明确Lombok仅为编译时依赖），同时补充测试环境的Lombok依赖：

<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <scope>provided</scope>
</dependency>
<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <scope>test</scope>
    <optional>true</optional>
</dependency>

步骤2：配置Maven编译插件的注解处理器 #

确保Maven编译阶段能识别Lombok的注解处理器，在build/plugins中添加或修改以下配置：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <configuration>
        <annotationProcessorPaths>
            <path>
                <groupId>org.projectlombok</groupId>
                <artifactId>lombok</artifactId>
                <version>${lombok.version}</version>
            </path>
        </annotationProcessorPaths>
    </configuration>
</plugin>

步骤3：清理并重新编译项目 #

执行Maven命令清理旧编译产物并重新编译：

mvn clean compile test-compile

额外提示 #

你的Student类中存在拼写错误：gaurdianName、gaurdianEmail、gaurdianMobile应为guardianName、guardianEmail、guardianMobile，虽不影响当前功能，但建议修正以避免后续问题。

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