MapStruct生成错误映射实现问题排查求助

核心问题分析 #

生成的实现未做任何字段映射，主要源于两个关键问题：

• Lombok与MapStruct处理器执行顺序冲突：你使用Lombok的@Data注解生成getter/setter，但当前Maven配置未明确处理器顺序。MapStruct依赖实体的getter/setter识别字段，如果MapStruct处理器先于Lombok运行，就无法看到自动生成的方法，自然不会生成映射逻辑。
• 字段类型不匹配：User的birthDate是LocalDate类型，而UserDto的birthDate是String类型，MapStruct不会自动处理这种跨类型转换，需要手动指定转换规则。

解决方案 #

1. 调整Maven配置，确保Lombok先于MapStruct执行 #

修改pom.xml，添加maven-compiler-plugin明确注解处理器顺序，让Lombok先生成getter/setter，再由MapStruct处理：

<properties>
    <java.version>17</java.version>
    <lombok.version>1.18.30</lombok.version> <!-- 适配Java17的稳定版本 -->
</properties>

<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>
        <!-- 配置注解处理器顺序 -->
        <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>
                    <path>
                        <groupId>org.projectlombok</groupId>
                        <artifactId>lombok</artifactId>
                        <version>${lombok.version}</version>
                    </path>
                    <path>
                        <groupId>org.projectlombok</groupId>
                        <artifactId>lombok-mapstruct-binding</artifactId>
                        <version>0.2.0</version>
                    </path>
                    <path>
                        <groupId>org.mapstruct</groupId>
                        <artifactId>mapstruct-processor</artifactId>
                        <version>1.6.0.Beta1</version>
                    </path>
                </annotationProcessorPaths>
            </configuration>
        </plugin>
    </plugins>
</build>

2. 处理birthDate类型转换问题 #

针对LocalDate与String的转换，有两种实现方式：

方式一：使用MapStruct内置日期转换

在Mapper接口的方法上添加@Mapping注解指定日期格式：

@Mapper(componentModel = "spring")
public interface UserMapper {
    @Mapping(target = "birthDate", source = "birthDate", dateFormat = "dd/MM/yyyy")
    UserDto userToUserDto(User user);

    @Mapping(target = "birthDate", source = "birthDate", dateFormat = "dd/MM/yyyy")
    User userDtoToUser(UserDto userDto);

    List<UserDto> usersToUserDtos(List<User> users);
}

方式二：自定义转换器（更灵活）

编写自定义转换类处理日期格式：

// LocalDate转String
public class LocalDateToStringConverter implements Converter<LocalDate, String> {
    @Override
    public String convert(LocalDate source) {
        return source == null ? null : DateTimeFormatter.ofPattern("dd/MM/yyyy").format(source);
    }
}

// String转LocalDate
public class StringToLocalDateConverter implements Converter<String, LocalDate> {
    @Override
    public LocalDate convert(String source) {
        return source == null || source.isBlank() ? null : LocalDate.parse(source, DateTimeFormatter.ofPattern("dd/MM/yyyy"));
    }
}

然后在Mapper中引用这些转换器：

@Mapper(componentModel = "spring", uses = {LocalDateToStringConverter.class, StringToLocalDateConverter.class})
public interface UserMapper {
    UserDto userToUserDto(User user);
    User userDtoToUser(UserDto userDto);
    List<UserDto> usersToUserDtos(List<User> users);
}

3. 升级MapStruct版本（可选） #

你当前使用的是1.6.0.Beta1测试版本，可能存在兼容性问题，建议升级到稳定版本，比如1.5.5.Final，对Java17和Spring Boot 3的适配更完善：

<dependency>
    <groupId>org.mapstruct</groupId>
    <artifactId>mapstruct</artifactId>
    <version>1.5.5.Final</version>
</dependency>
<dependency>
    <groupId>org.mapstruct</groupId>
    <artifactId>mapstruct-processor</artifactId>
    <version>1.5.5.Final</version>
</dependency>

验证步骤 #

1. 执行mvn clean compile清理旧编译文件，重新编译项目
2. 查看target/generated-sources/annotations下生成的UserMapperImpl，确认字段映射代码已生成
3. 编写测试用例，验证实体与DTO之间的字段转换是否正常

内容的提问来源于stack exchange，提问作者Haitam-Elgharras