Lombok 在测试类中无法使用：问题诊断与解决方案-java教程-PHP中文网

Lombok 在测试类中无法使用：问题诊断与解决方案

聖光之護

发布： 2025-09-02 17:48:01

原创

765人浏览过

lombok 在测试类中无法使用：问题诊断与解决方案

本文旨在解决 Lombok 在 Spring Boot 项目测试类中无法使用的问题。通过分析 Maven 依赖配置，指出 lombok 依赖的配置问题，并提供解决方案，确保在测试环境中也能正常使用 Lombok 的注解功能，如 @Data、@Builder 等，从而简化代码并提高开发效率。

Lombok 是一款非常流行的 Java 库，它通过注解的方式自动生成样板代码，例如 getters、setters、构造函数、equals()、hashCode() 和 toString() 方法。然而，在 Spring Boot 项目中，有时会遇到在测试类中无法使用 Lombok 生成的功能的情况。本文将详细分析可能的原因并提供解决方案。

问题分析

通常，当你在实体类上使用了 Lombok 的注解（如 @Data、@Builder 等），但在测试类中却无法访问生成的 getter、setter 或 builder 方法时，问题往往出在 Maven 的依赖配置上。具体来说，可能是 lombok 依赖的作用域配置不正确。

解决方案

正确的做法是确保 lombok 依赖在测试类路径中可用。这可以通过将 lombok 依赖的作用域设置为 provided 来实现。

在 pom.xml 文件中，修改 lombok 依赖的配置如下：

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

登录后复制

解释：

<scope>provided</scope>: provided 作用域意味着该依赖在编译和测试时可用，但在运行时由容器（例如，Servlet 容器或 JVM）提供。对于 Lombok 来说，这意味着 Lombok 注解处理器在编译时会生成相应的代码，但在运行时不需要 Lombok 库本身。

完整示例

以下是一个完整的 pom.xml 文件的示例，展示了如何正确配置 lombok 依赖：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.example</groupId>
    <artifactId>demo</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>demo</name>
    <description>Demo project for Spring Boot</description>
    <properties>
        <java.version>17</java.version>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-data-jpa</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <dependency>
            <groupId>com.mysql</groupId>
            <artifactId>mysql-connector-j</artifactId>
            <scope>runtime</scope>
        </dependency>

        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <scope>provided</scope>
            <optional>true</optional>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <configuration>
                    <excludes>
                        <exclude>
                            <groupId>org.projectlombok</groupId>
                            <artifactId>lombok</artifactId>
                        </exclude>
                    </excludes>
                </configuration>
            </plugin>
        </plugins>
    </build>

</project>

登录后复制

注意：

<optional>true</optional>：这个配置项表示该依赖是可选的。如果其他项目依赖于你的项目，并且它们也使用了 Lombok，那么它们不需要显式地声明 Lombok 依赖。

排除 Lombok 插件配置

在某些情况下，<excludes> 配置可能会阻止 Lombok 在编译时生效。请确保你的 spring-boot-maven-plugin 配置中没有排除 lombok：

无涯·问知

无涯·问知，是一款基于星环大模型底座，结合个人知识库、企业知识库、法律法规、财经等多种知识源的企业级垂直领域问答产品

查看详情

<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <configuration>
        <excludes>
            <!-- 确保这里没有排除 lombok -->
        </excludes>
    </configuration>
</plugin>

登录后复制

如果你的 excludes 配置中包含了 lombok，请将其移除。

清理和重新构建项目

在修改 pom.xml 文件后，建议执行以下操作：

清理项目： 在 IDE 中选择 "Build" -> "Clean Project" 或在命令行中运行 mvn clean。
重新构建项目： 在 IDE 中选择 "Build" -> "Rebuild Project" 或在命令行中运行 mvn install。

这可以确保 Maven 正确地重新下载和处理依赖项。

示例代码验证

假设你有一个 Student 实体类，使用了 Lombok 的 @Data 和 @Builder 注解：

import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.NoArgsConstructor;

import javax.persistence.Column;
import javax.persistence.Entity;

@Entity
@Data
@AllArgsConstructor
@NoArgsConstructor
@Builder
public class Student {
    private String firstName;
    private String lastName;

    @Column(name = "email_address",
            nullable = false
    )
    private String emailId;
    private String gaurdianName;
    private String gaurdianEmail;
    private String gaurdianMobile;

}

登录后复制

在测试类中，你可以这样使用 Lombok 生成的功能：

import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.*;

public class StudentTest {

    @Test
    void testStudentBuilder() {
        Student student = Student.builder()
                .firstName("John")
                .lastName("Doe")
                .emailId("john.doe@example.com")
                .build();

        assertEquals("John", student.getFirstName());
        assertEquals("Doe", student.getLastName());
        assertEquals("john.doe@example.com", student.getEmailId());
    }
}

登录后复制

如果配置正确，测试应该能够成功运行，并且你可以正常访问 Student 类的 getter 方法和使用 builder 模式创建对象。

总结

通过将 lombok 依赖的作用域设置为 provided，并确保 spring-boot-maven-plugin 配置中没有排除 lombok，可以解决 Lombok 在测试类中无法使用的问题。遵循以上步骤，可以确保 Lombok 在你的 Spring Boot 项目中正常工作，从而简化代码并提高开发效率。

以上就是Lombok 在测试类中无法使用：问题诊断与解决方案的详细内容，更多请关注php中文网其它相关文章！