MapStruct 默认支持字符串到枚举的自动映射（区分大小写、按名称匹配），无需手动编写 @ValueMapping，只需确保源字符串与枚举常量名完全一致即可。
mapstruct 默认支持字符串到枚举的自动映射（区分大小写、按名称匹配），无需手动编写 `@valuemapping`，只需确保源字符串与枚举常量名完全一致即可。
在使用 MapStruct 将 DTO 中的 String 字段映射为 Java 枚举类型（如 MyEnum）时，关键在于理解 MapStruct 的默认枚举映射机制：它会自动尝试通过 Enum.valueOf() 按枚举常量的 精确名称（name） 进行匹配，前提是字符串值与枚举常量名严格一致（例如 "ONE" → MyEnum.ONE）。
以下是一个完整、可运行的示例：
// 枚举定义
public enum MyEnum {
ONE, TWO;
}
// DTO 类（来源）
public class MyDTO {
private String value;
public String getValue() { return value; }
public void setValue(String value) { this.value = value; }
}
// 目标实体类
public class MyClass {
private MyEnum value;
public MyEnum getValue() { return value; }
public void setValue(MyEnum value) { this.value = value; }
}
// MapStruct 映射器（启用 Spring 组件模型）
@Mapper(componentModel = "spring")
public interface MyDTOMapper {
@Mapping(source = "value", target = "value")
MyClass toMyClass(MyDTO dto);
}
✅ 关键说明：
- 不需要
@ValueMapping或自定义方法——MapStruct 会自动调用MyEnum.valueOf("ONE")； - 字符串必须完全匹配枚举常量名（如
"ONE"✅，"one-code"❌，"one"❌）； - 若需不区分大小写或自定义映射逻辑（如
"one-code"→MyEnum.ONE），才需显式声明@ValueMapping或@Named方法； - 确保编译时启用了 MapStruct 注解处理器（如 Maven 中配置
mapstruct-processor）。
⚠️ 注意事项：
- 若输入字符串不匹配任何枚举常量（如
"THREE"），valueOf()将抛出IllegalArgumentException，建议在生产环境中配合@AfterMapping或自定义映射方法做容错处理； - 使用
componentModel = "spring"可让生成的实现类被 Spring 自动注入； - 避免在
@ValueMapping中错误地将source设为字面量（如"one-code"）、target设为枚举实例（如"ONE"）——正确写法应为source = "one-code"、target = "ONE"，且需配合@IterableMapping或@ValueMapping在方法级声明。
运行验证：
public static void main(String[] args) {
MyDTOMapper mapper = Mappers.getMapper(MyDTOMapper.class); // 推荐方式（非 new Impl）
MyDTO dto = new MyDTO();
dto.setValue("ONE");
MyClass result = mapper.toMyClass(dto);
System.out.println(result.getValue()); // 输出：ONE
}
综上，MapStruct 对 String ↔ Enum 的映射简洁高效，优先依赖默认行为；仅当业务逻辑要求非标准转换时，再引入显式映射策略。
