Mapstruct子类映射异常：Mediation映射仅返回Person DTO字段

问题根源是Mapstruct默认处理父类类型属性时，只会匹配父类的映射规则，不会自动识别子类并调用对应子类的映射方法，以下是具体解决步骤和代码示例：

1. 确保子类映射规则定义完整 #

首先需要为每个子类（RealPerson、LegalPerson）定义对应的DTO映射方法，可在父类Mapper中统一管理：

@Mapper(componentModel = "spring")
public interface PersonMapper {
    // 核心：用@SubclassMapping指定子类到对应DTO的映射（Mapstruct 1.4+版本支持）
    @SubclassMapping(source = RealPerson.class, target = RealPersonDTO.class)
    @SubclassMapping(source = LegalPerson.class, target = LegalPersonDTO.class)
    PersonDTO toDto(Person person);

    // 也可以显式定义子类映射方法，Mapstruct会自动匹配类型
    RealPersonDTO toRealPersonDto(RealPerson realPerson);
    LegalPersonDTO toLegalPersonDto(LegalPerson legalPerson);
}

如果使用Mapstruct 1.4以下版本，可通过自定义默认方法实现类型判断：

@Mapper(componentModel = "spring")
public interface PersonMapper {
    default PersonDTO toDto(Person person) {
        if (person instanceof RealPerson) {
            return toRealPersonDto((RealPerson) person);
        } else if (person instanceof LegalPerson) {
            return toLegalPersonDto((LegalPerson) person);
        }
        throw new IllegalArgumentException("不支持的Person子类类型：" + person.getClass());
    }

    RealPersonDTO toRealPersonDto(RealPerson realPerson);
    LegalPersonDTO toLegalPersonDto(LegalPerson legalPerson);
}

2. 在MediationMapper中引用子类映射规则 #

在处理Mediation类的Mapper中，通过uses属性引入PersonMapper，确保Mapstruct能找到子类的映射逻辑：

@Mapper(componentModel = "spring", uses = PersonMapper.class)
public interface MediationMapper {
    MediationDTO toDto(Mediation mediation);
}

如果需要更明确指定映射方法，也可以用qualifiedByName：

// 先给PersonMapper的方法命名
@Mapper(componentModel = "spring")
public interface PersonMapper {
    @Named("personToDto")
    PersonDTO toDto(Person person);

    @Named("realPersonToDto")
    RealPersonDTO toRealPersonDto(RealPerson realPerson);

    @Named("legalPersonToDto")
    LegalPersonDTO toLegalPersonDto(LegalPerson legalPerson);
}

// 然后在MediationMapper中指定使用命名的方法
@Mapper(componentModel = "spring", uses = PersonMapper.class)
public interface MediationMapper {
    @Mapping(target = "applicant", qualifiedByName = "personToDto")
    @Mapping(target = "respondent", qualifiedByName = "personToDto")
    MediationDTO toDto(Mediation mediation);
}

3. 验证关键点 #

• 确保子类实体和DTO的字段映射正确（可通过@Mapping指定字段对应关系）
• 检查Mapstruct版本，1.4+推荐用@SubclassMapping更简洁
• 启动Spring Boot时，确保Mapper被正确扫描（可通过@MapperScan指定包路径）

内容的提问来源于stack exchange，提问作者Anıl İlağa