MapStruct中如何忽略DTO内Enum字段的自动映射？

问题核心 #

你之前的配置错误在于将@Mapping注解加在了集合映射方法上，并且使用了错误的source/target值（比如枚举类名、枚举值这些都不是属性名），导致MapStruct没有正确识别忽略规则。

正确配置方式 #

MapStruct处理集合映射时，会自动复用单个对象的映射逻辑，因此你需要在单个Document转DocumentDTO的方法上添加忽略注解，而不是集合方法上。

完整的DocumentsMapper配置如下：

@Mapper
public interface DocumentsMapper {

    // 单个对象映射：在此处配置忽略规则
    @Mapping(source = "type", target = "type", ignore = true)
    DocumentDTO toDocumentDTO(Document document);

    // 集合映射自动复用上面的单个映射逻辑，无需额外注解
    List<DocumentDTO> mapper(List<Document> documents);

    @AfterMapping
    default void afterMapping(Document document, @MappingTarget DocumentDTO documentDTO) {
        // 若需要手动处理type字段，可在此添加逻辑
        // 例如：documentDTO.setType(DocumentsEnum.valueOf(document.getType()));
    }
}

关键说明 #

1. 注解位置：集合映射方法本身不处理字段映射细节，所有字段级别的配置都要放在单个对象的映射方法上。
2. 正确的属性名：source和target必须对应实体和DTO中的属性名（这里都是type），不要用枚举类名、枚举值或枚举名称来配置。
3. 忽略后的行为：忽略type字段后，DTO中的type会保持默认值（通常为null），如果需要自定义赋值逻辑，可以在@AfterMapping方法中手动实现。

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