在 MapStruct 映射中，当源对象字段多于目标对象时，可通过 @Mapping(target = "fieldName", ignore = true) 显式忽略目标类中不存在（或无需映射）的字段，从而精准消除“Unmapped target properties”警告，避免全局策略误伤其他未映射字段。
在 mapstruct 映射中，当源对象字段多于目标对象时，可通过 `@mapping(target = "fieldname", ignore = true)` 显式忽略目标类中不存在（或无需映射）的字段，从而精准消除“unmapped target properties”警告，避免全局策略误伤其他未映射字段。
MapStruct 默认会对所有未显式声明映射关系的目标（target）字段发出警告（如 Unmapped target properties: "t3"），尤其在从字段更丰富的类（如 B）映射到字段较少的类（如 A）时常见。虽然 unmappedTargetPolicy = ReportingPolicy.IGNORE 可全局抑制此类警告，但它会掩盖潜在遗漏——例如后续新增字段却未被察觉。
✅ 正确做法是：在 Mapper 接口的方法上，使用 @Mapping 注解并指定 target 为待忽略的目标字段名，同时设 ignore = true。注意：这里的 target 指的是映射操作的目标对象（即接收方）中的字段，而非数据来源；即使该字段在源对象中存在（如 B.t3），只要它在目标类 A 中不存在，MapStruct 仍将其视为“无法映射到的目标属性”，因此需通过 target = "t3" 告知框架：“此字段不参与映射，请静默忽略”。
以下是完整示例：
@Mapper
public interface ABMapper {
ABMapper INSTANCE = Mappers.getMapper(ABMapper.class);
@Mapping(target = "t3", ignore = true) // ✅ 关键：明确忽略目标侧不存在的字段 t3
A toA(B b);
}⚠️ 注意事项：
-
@Mapping(source = "t3", ignore = true)是错误的——因为t3并非A（目标）的字段，source必须对应源类B的字段，而target必须对应目标类A的字段；此处t3在A中根本不存在，所以不能作为source，但可作为target（表示“试图映射到 A.t3 这一不存在的属性”）。 -
target = "t3"中的"t3"是目标类（即方法返回类型A）中预期存在但实际缺失的字段名；MapStruct 依此识别出该 unmapped target property，并按ignore = true静默跳过。 - 若存在多个需忽略的字段，可重复添加
@Mapping，或使用@BeanMapping配合unmappedTargetPolicy（仅推荐用于极少数固定场景，非首选）。
总结：精准控制字段映射行为的关键在于理解 MapStruct 的“target-centric”警告机制——所谓 unmapped target property，本质是“框架尝试将源数据填入目标字段时发现目标无此字段”。因此，用 @Mapping(target = "xxx", ignore = true) 是语义最准确、粒度最细、安全性最高的解决方案。
