Khi sử dụng Lombok trong dự án Java, bạn có thể gặp lỗi “không tìm thấy biểu tượng” khi chạy lệnh mvn install hoặc biên dịch mã nguồn. Điều này thường xảy ra do các chú thích (annotations) của Lombok không hoạt động đúng cách. Có nhiều nguyên nhân có thể gây ra vấn đề này, bao gồm thiếu plugin IDE, xung đột phụ thuộc Maven hoặc cấu hình biên dịch không đúng.

Kiểm Tra Phụ Thuộc Lombok Đã Nhập Chính Xác Hay Chưa

Hãy đảm bảo rằng Lombok đã được thêm vào file pom.xml với phiên bản tương thích với dự án:

<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <version>1.18.30</version> <!-- Sử dụng phiên bản ổn định mới nhất -->
    <scope>provided</scope>
</dependency>

Lưu ý:

• Phải thiết lập <scope>provided</scope>, vì Lombok chỉ hoạt động trong giai đoạn biên dịch.
• Nếu sử dụng cùng các bộ xử lý chú thích khác như MapStruct, hãy đảm bảo thứ tự phụ thuộc chính xác.

Xác Nhận Plugin IDE Đã Cài Đặt

Lombok cần một plugin được cài đặt trong môi trường phát triển để hoạt động. Dưới đây là cách cài đặt plugin cho các IDE phổ biến:

IntelliJ IDEA

1. Mở File -> Settings -> Plugins.
2. Tìm kiếm Lombok Plugin và cài đặt.
3. Bật xử lý chú thích: Settings -> Build, Execution, Deployment -> Compiler -> Annotation Processors -> Enable annotation processing.

Eclipse

1. Tải xuống gói JAR của Lombok (phải khớp với phiên bản phụ thuộc).
2. Chạy lệnh java -jar lombok.jar, chọn đường dẫn cài đặt Eclipse để hoàn tất việc cài đặt.

Kiểm Tra Cấu Hình Biên Dịch Maven

Trong file pom.xml, cấu hình rõ ràng plugin trình biên dịch Maven để hỗ trợ xử lý chú thích:

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.11.0</version>
            <configuration>
                <annotationProcessorPaths>
                    <path>
                        <groupId>org.projectlombok</groupId>
                        <artifactId>lombok</artifactId>
                        <version>1.18.30</version>
                    </path>
                </annotationProcessorPaths>
            </configuration>
        </plugin>
    </plugins>
</build>