mapstruct 在映射时若目标类存在源类中没有的字段（如 b→a 时 b 多出 t3），默认会警告“unmapped target properties”。本文介绍如何精准忽略单个目标字段（如 t3），而非全局禁用警告。
mapstruct 在映射时若目标类存在源类中没有的字段（如 b→a 时 b 多出 t3），默认会警告“unmapped target properties”。本文介绍如何精准忽略单个目标字段（如 t3），而非全局禁用警告。
在 MapStruct 中，当执行 从源类（source）向目标类（target）映射 时（例如 B toB(A a) 表示将 A 映射为 B），若目标类 B 比源类 A 多出字段（如 t3），MapStruct 会检测到该字段无法从 A 获取值，从而抛出警告：
Warning: Unmapped target properties: "t3"
此时，你不需要也不应该尝试写 @Mapping(source = "t3", ignore = true) —— 因为 t3 并不存在于源类 A 中，source = "t3" 会导致编译错误或解析失败。
✅ 正确做法是：将 t3 视为目标字段（target），显式声明其被忽略：
@Mapper
public interface MyMapper {
@Mapping(target = "t3", ignore = true)
B toB(A a);
}⚠️ 关键点：
@Mapping(target = "...", ignore = true)中的target指的是目标类（B）中的字段名，与映射方向无关。MapStruct 会据此跳过对该字段的赋值和校验，从而消除对应警告。
此外，还可结合 unmappedTargetPolicy 实现更精细的控制：
-
全局忽略所有未映射目标字段（不推荐，易掩盖问题）：
@Mapper(unmappedTargetPolicy = ReportingPolicy.IGNORE)
-
仅对当前方法忽略特定字段（推荐，精准可控）：
@Mapper public interface MyMapper { @Mapping(target = "t3", ignore = true) @Mapping(target = "createdAt", ignore = true) // 可链式忽略多个 B toB(A a); }
? 注意事项：
-
ignore = true仅影响字段映射逻辑，不会生成任何赋值代码（即b.setT3(null)不会出现）； - 若目标字段为
final或无 setter，MapStruct 会报错，此时需确保字段可写或改用@Builder等构造器映射； - 使用 Lombok 时，确保
@Setter或@Data已正确生成 setter 方法； - 建议配合
@Mapper(uses = {...})和@Named实现复杂字段的自定义处理，避免过度依赖ignore。
通过 @Mapping(target = "xxx", ignore = true)，你能在保持严格映射检查的同时，灵活排除个别冗余字段——这是 MapStruct 推荐的、类型安全且可维护的解决方案。
