MapStruct 可以自动将 DTO 中的 String 字段映射为同名枚举常量（如 "ONE" → MyEnum.ONE），无需手动编写 @ValueMapping，前提是字符串值与枚举名称严格一致且启用默认转换策略。
mapstruct 可以自动将 dto 中的 string 字段映射为同名枚举常量（如 `"one"` → `myenum.one`），无需手动编写 `@valuemapping`，前提是字符串值与枚举名称严格一致且启用默认转换策略。
在使用 MapStruct 进行 String 到 Enum 的映射时，最简洁可靠的方式是依赖其内置的枚举自动转换机制，而非显式声明 @ValueMapping。MapStruct 默认支持从字符串按枚举常量名称（name()）进行匹配转换——即当 DTO 中的字符串值（如 "ONE"）恰好等于枚举类中某个常量的名称（MyEnum.ONE）时，会自动完成映射。
✅ 正确做法如下：
-
确保枚举定义规范（无额外构造逻辑，名称为大写蛇形或符合 Java 常量命名）：
public enum MyEnum { ONE, TWO; } -
DTO 与目标类字段命名一致或通过
@Mapping显式指定：public class MyDTO { private String value; // 值为 "ONE" 或 "TWO" // getter/setter... }
public class MyClass { private MyEnum value; // getter/setter... }
3. **定义 Mapper 接口（推荐启用 Spring 组件模型）**：
```java
@Mapper(componentModel = "spring")
public interface MyDTOMapper {
@Mapping(source = "value", target = "value")
MyClass toMyClass(MyDTO dto);
}⚠️ 注意：无需
@ValueMapping！MapStruct 编译时会自动生成基于Enum.valueOf()的安全转换逻辑（内部已处理IllegalArgumentException并转为null或抛出映射异常，取决于配置）。
-
使用示例（确保生成实现类可用）：
public static void main(String[] args) { MyDTOMapper mapper = Mappers.getMapper(MyDTOMapper.class); // 或通过 Spring 注入 MyDTO dto = new MyDTO(); dto.setValue("ONE"); MyClass result = mapper.toMyClass(dto); System.out.println(result.getValue()); // 输出：ONE }
? 关键注意事项：
- 字符串必须精确匹配枚举常量名（区分大小写、无空格/前缀）；若需自定义映射逻辑（如
"one-code"→ONE），才应使用@ValueMapping或@Named+ 自定义方法； - 若字符串可能为空或非法，建议配合
@NullValueMapping或全局配置unmappedTargetPolicy = ReportingPolicy.IGNORE避免运行时异常； - 使用 Lombok 时，确保
@Builder/@Data不干扰 MapStruct 的字段访问逻辑； - 编译需启用 annotation processor（如 Maven 中配置
mapstruct-processor）以生成MyDTOMapperImpl。
总结：优先信任 MapStruct 的默认枚举转换能力——简洁、类型安全、零样板代码。仅在业务语义与枚举名不一致时，再引入显式映射策略。
