MapStruct 默认支持字符串到枚举的自动映射（区分大小写、按名称匹配），无需手动编写 @ValueMapping，只需确保源字符串与枚举常量名完全一致即可。
mapstruct 默认支持字符串到枚举的自动映射（区分大小写、按名称匹配），无需手动编写 `@valuemapping`，只需确保源字符串与枚举常量名完全一致即可。
在使用 MapStruct 将 DTO 中的 String 字段映射为 Java 枚举时，许多开发者误以为必须显式声明 @ValueMapping，但实际上 MapStruct 提供了开箱即用的枚举名称自动解析机制：只要源字符串的值与目标枚举常量的 name() 完全相同（严格区分大小写），MapStruct 会自动完成转换。
✅ 正确做法如下：
-
定义枚举（保持标准命名）：
public enum MyEnum { ONE, TWO; } -
定义 DTO 和目标类（字段名建议一致，便于自动映射）：
public class MyDTO { private String value; // getter/setter }
public class MyClass { private MyEnum value; // getter/setter }
3. **声明 Mapper 接口**（启用 Spring 组件模型，便于注入）：
```java
@Mapper(componentModel = "spring")
public interface MyDTOMapper {
MyClass toMyClass(MyDTO dto);
}⚠️ 注意：无需
@Mapping注解——当MyDTO.value（String）与MyClass.value（MyEnum）字段名相同且类型可匹配时，MapStruct 会自动应用内置的String → Enum转换器。
-
使用示例：
MyDTOMapper mapper = Mappers.getMapper(MyDTOMapper.class); MyDTO dto = new MyDTO(); dto.setValue("ONE"); // 必须是 "ONE"，而非 "one-code" 或 "one" MyClass result = mapper.toMyClass(dto); System.out.println(result.getValue()); // 输出：ONE
❌ 常见错误排查：
- 字符串值不匹配枚举常量名（如传
"one"→MyEnum.ONE失败，因ONE.name()是"ONE"）； - 未启用
componentModel = "spring"（若需 Spring 管理 Bean）； - 错误使用
@ValueMapping绑定自定义字符串（如"one-code"→ONE），此时才需显式配置——但应改用@ValueMapping(source = "one-code", target = "ONE")并配合String到MyEnum的专用方法，而非放在主映射方法中。
? 进阶提示：如需支持别名映射（如 "one-code" → MyEnum.ONE），应单独定义转换方法并标注 @Named，再通过 qualifiedByName 引用：
@Mapper(componentModel = "spring")
public interface MyDTOMapper {
@Mapping(source = "value", target = "value", qualifiedByName = "stringToMyEnum")
MyClass toMyClass(MyDTO dto);
@Named("stringToMyEnum")
default MyEnum stringToMyEnum(String value) {
return switch (value) {
case "one-code" -> MyEnum.ONE;
case "two-code" -> MyEnum.TWO;
default -> null; // 或抛异常
};
}
}总之，优先利用 MapStruct 的默认行为；仅在业务需要非标准字符串映射时，再引入定制逻辑——简洁、安全、可维护。
