如何使用MapStruct映射参数化类型不同的Map字段？

你可以直接通过在CarMapper中定义键类型转换方法，配合@Mapping注解实现这个映射，完全不需要@AfterMapping。

第一步：修正DTO的泛型（可选但建议） #

首先注意你的CarDto中optionsByGroupId的泛型应该是Map<Long, OptionDto>（而非Map<Long, Option>），否则和OptionMapper的转换逻辑不匹配，会导致类型错误。

第二步：配置CarMapper #

在CarMapper中添加一个Group转Long的默认方法，MapStruct会自动用这个方法转换Map的键；同时通过@Mapping指定字段映射关系：

@Mapper(componentModel = "spring", uses = OptionMapper.class)
public abstract class CarMapper {

    @Mapping(source = "optionsByGroup", target = "optionsByGroupId")
    public abstract CarDto from(Car car);

    // 定义Group到Long的转换方法，用于Map键的转换
    default Long mapGroupToId(Group group) {
        return group != null ? group.getId() : null;
    }
}

原理说明 #

• MapStruct会自动识别Group到Long的转换方法，并将其应用到Map<Group, Option>的每个键上，把Group对象转为对应的id值。
• Map值的转换则会通过uses = OptionMapper.class指定的OptionMapper，自动把Option转为OptionDto。

更明确的写法（可选） #

如果需要更清晰地标记转换逻辑，可以用@Named注解配合keyQualifiedByName：

@Mapper(componentModel = "spring", uses = OptionMapper.class)
public abstract class CarMapper {

    @Mapping(
        source = "optionsByGroup", 
        target = "optionsByGroupId",
        keyQualifiedByName = "groupToId"
    )
    public abstract CarDto from(Car car);

    @Named("groupToId")
    default Long mapGroupToId(Group group) {
        return group != null ? group.getId() : null;
    }
}

这样可以明确指定Map键使用哪个转换方法，避免多个同类型转换方法时的歧义。

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