如何配置ModelMapper仅映射源与目标的完全匹配字段？

核心问题拆解 #

你遇到的是MapStruct中匹配策略和必填字段映射的双重冲突：

• STRICT策略要求源和目标属性完全匹配（数量、名称一致），但类结构不满足，导致无法执行更新
• STANDARD策略会自动按驼峰/下划线匹配（id → personId），不符合业务需求
• 手动跳过id字段后，目标的personId是必填项，触发"A mapping is missing a required destination member"错误

具体解决步骤 #

1. 自定义字段映射规则，覆盖自动匹配 #

通过@Mapping注解明确指定字段映射关系，同时保留必填字段的映射：

@Mapper(componentModel = "spring")
public interface PersonMapper {
    @Mapping(source = "personId", target = "personId") // 明确映射目标必填字段
    @Mapping(target = "id", ignore = true) // 忽略源中的id字段，不映射到目标
    void updatePersonFromDto(PersonDto source, @MappingTarget Person target);
}

关键在于：显式声明必填字段personId的映射（即使源和目标字段名一致，也明确写出），同时忽略不需要的id字段，既避免自动匹配的错误映射，又满足必填字段的要求。

2. 调整匹配策略为STANDARD（或DEFAULT） #

无需强制使用STRICT，通过显式注解精准控制映射，让策略作为兜底：

@Mapper(componentModel = "spring", matchingStrategy = MatchingStrategy.STANDARD)
public interface PersonMapper {
    // 同上的@Mapping配置
}

STANDARD策略会优先执行你显式定义的@Mapping规则，仅对未定义的字段自动匹配，既灵活又能避免错误映射。

3. 检查目标类的必填字段配置 #

如果personId是JPA实体主键或必填字段，确保映射时不会被忽略：

• 不要给personId加ignore = true
• 若为更新操作，目标对象本身已有personId，使用@MappingTarget可保留原有值，无需从源对象传入

关键注意点 #

• 显式映射优先级高于自动匹配：无论使用哪种策略，@Mapping注解的规则都会被优先执行
• 使用@MappingTarget更新现有对象时，目标对象的已有字段（如personId）会被保留，除非显式覆盖
• 避免盲目使用STRICT策略：仅当源和目标类字段完全一致时适用，多数场景下STANDARD+显式注解更灵活

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