java全家桶之7：java lomok 与map structure 冲突解决

Java项目中同时使用Lombok和MapStruct时，常因注解处理顺序冲突导致编译错误。解决方案包括：1)确保pom.xml或build.gradle中Lombok先于MapStruct执行；2)检查实体类正确使用@Data或@Getter/@Setter；3)可选手动指定@Mapping；4)清理缓存重新编译。关键点是保证Lombok先处理生成getter/setter，MapStruct后读取生成代码。采用最新版本并重置缓存后，大多数冲突问题都能解决。

在 Java 项目中同时使用 Lombok 和 MapStruct 时，可能会因为注解处理顺序问题导致冲突，常见错误如下： 

java: No property named "xxx" exists in source parameter(s).

或编译时 Lombok 未生成 getter/setter，导致 MapStruct 找不到属性。

解决方案

1. 确保正确的依赖配置

Maven 项目

在 pom.xml 中正确配置 Lombok 和 MapStruct 的依赖及注解处理器顺序：

xml

复制

下载

运行

<dependencies>
    <!-- Lombok -->
    <dependency>
        <groupId>org.projectlombok</groupId>
        <artifactId>lombok</artifactId>
        <version>1.18.30</version>
        <scope>provided</scope>
    </dependency>

    <!-- MapStruct -->
    <dependency>
        <groupId>org.mapstruct</groupId>
        <artifactId>mapstruct</artifactId>
        <version>1.5.5.Final</version>
    </dependency>
</dependencies>

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.11.0</version>
            <configuration>
                <source>17</source>
                <target>17</target>
                <!-- 确保注解处理器顺序正确 -->
                <annotationProcessorPaths>
                    <!-- Lombok 先执行 -->
                    <path>
                        <groupId>org.projectlombok</groupId>
                        <artifactId>lombok</artifactId>
                        <version>1.18.30</version>
                    </path>
                    <!-- MapStruct 后执行 -->
                    <path>
                        <groupId>org.mapstruct</groupId>
                        <artifactId>mapstruct-processor</artifactId>
                        <version>1.5.5.Final</version>
                    </path>
                </annotationProcessorPaths>
            </configuration>
        </plugin>
    </plugins>
</build>

Gradle 项目

在 build.gradle 中配置：

groovy

复制

下载

dependencies {
    // Lombok
    compileOnly 'org.projectlombok:lombok:1.18.30'
    annotationProcessor 'org.projectlombok:lombok:1.18.30'

    // MapStruct
    implementation 'org.mapstruct:mapstruct:1.5.5.Final'
    annotationProcessor 'org.mapstruct:mapstruct-processor:1.5.5.Final'
}

2. 确保 Lombok 先于 MapStruct 执行

MapStruct 依赖 Lombok 生成的 getter/setter，因此必须确保：

1. Lombok 先处理（生成 getter/setter）。

2. MapStruct 后处理（读取生成的代码）。

如果顺序错误，MapStruct 会找不到属性。

3. 检查实体类是否正确使用 Lombok

确保实体类使用了 @Data 或 @Getter/@Setter：

java

复制

下载

import lombok.Data;

@Data  // 自动生成 getter/setter
public class User {
    private Long id;
    private String name;
}

4. 手动指定 Mapper 实现（可选）

如果仍然报错，可以在 Mapper 接口中手动指定 @Mapping：

java

复制

下载

@Mapper
public interface UserMapper {
    @Mapping(source = "id", target = "userId")
    UserDTO toDto(User user);
}

5. 清理并重新编译

执行以下命令清理缓存并重新编译：

bash

复制

下载

mvn clean compile  # Maven
gradle clean build # Gradle

常见问题排查

总结

1. 确保 Lombok 在 MapStruct 之前处理（关键！）。

2. 使用最新版本（Lombok 1.18.30+，MapStruct 1.5.5+）。

3. 清理缓存并重新编译。

按照上述步骤，99% 的冲突问题可以解决。如果仍有问题，可以尝试 手动生成 getter/setter 或检查日志详细错误。