如何使用MapStruct将String类型映射为Enum枚举类型？

你当前的写法没生效，大概率是MapStruct没正确关联自定义的枚举转换方法，或者配置细节没到位，以下是具体解决步骤：

1. 显式关联转换方法与字段映射 #

如果MyClass中的枚举字段和MyDTO的字符串字段需要自定义映射，必须让MapStruct明确知道要用你的toMyEnum方法来处理这个字段转换。可以通过@Named和qualifiedByName来绑定：

import org.mapstruct.Mapper;
import org.mapstruct.Mapping;
import org.mapstruct.Named;
import org.mapstruct.ValueMapping;

@Mapper(componentModel = "spring") // 根据项目需求选择，比如spring、cdi等
interface MyEnumMapper {
    // 显式指定字段使用自定义转换方法
    @Mapping(target = "myEnumField", source = "dtoStringField", qualifiedByName = "toMyEnum")
    MyClass map(MyDTO response);

    // 给转换方法命名，方便字段映射引用
    @Named("toMyEnum")
    @ValueMapping(target = "ONE", source = "one-code")
    MyEnum toMyEnum(String value);
}

注意替换myEnumField为MyClass中的枚举字段名，dtoStringField为MyDTO中的字符串字段名。

2. 批量处理多枚举值映射 #

如果有多个枚举值需要映射（比如TWO对应two-code），用@ValueMappings包裹多个@ValueMapping：

@Named("toMyEnum")
@ValueMappings({
    @ValueMapping(target = "ONE", source = "one-code"),
    @ValueMapping(target = "TWO", source = "two-code")
})
MyEnum toMyEnum(String value);

如果映射规则有规律（比如字符串是枚举名小写加-code），可以用批量匹配简化配置：

@Named("toMyEnum")
@EnumMapping(nameTransformationStrategy = "case", configuration = "lower")
@ValueMapping(target = "*", source = "*-code")
MyEnum toMyEnum(String value);

3. 处理未匹配的字符串值 #

如果存在无法匹配的字符串，需要指定默认行为避免编译错误，比如返回默认枚举值或null：

@Named("toMyEnum")
@ValueMappings({
    @ValueMapping(target = "ONE", source = "one-code"),
    @ValueMapping(target = "TWO", source = "two-code")
})
@EnumMapping(unmappedValue = MyEnum.ONE) // 未匹配时返回ONE
// 或者 @EnumMapping(unmappedValue = null) 允许返回null
MyEnum toMyEnum(String value);

4. 排查编译后的实现类 #

MapStruct会生成对应的实现类，你可以查看编译后的代码（通常在target/generated-sources/annotations目录下），确认toMyEnum方法是否正确实现了字符串到枚举的判断逻辑，这能快速定位配置是否生效。

内容的提问来源于stack exchange，提问作者Kusangai2