Java使用MapStruct映射不同类型Enum属性结果为null如何解决

问题根源 #

出现status字段为null的情况，是三个配置错误共同导致的：

• 枚举转换方法的入参、返回值类型完全写反，入参写成了Status而非需要被转换的State类型，根本匹配不上实际转换场景
• EntityMapper没有引入枚举转换器，MapStruct找不到跨枚举类型的转换规则，无法自动完成不同枚举类的赋值
• Entity侧枚举字段名为state，Domain侧枚举字段名为status，字段名不匹配，MapStruct默认不会对不同名字段做关联映射

具体修复步骤 #

1. 修正枚举转换器的方法定义，匹配State转Status的实际需求

public interface StatusMapper {
    default Status stateToStatus(State state) {
        if (state == null) {
            return null;
        }
        // 两个枚举的常量名完全一致，直接按枚举名称匹配取值即可
        return Status.valueOf(state.name());
    }
}

2. 修正EntityMapper配置，引入枚举转换器，同时显式指定不同名字段的映射关系

// 通过uses配置引入枚举转换器，MapStruct会自动识别类型匹配的转换方法并调用
@Mapper(uses = StatusMapper.class)
public interface EntityMapper {
    EntityMapper INSTANCE = Mappers.getMapper(EntityMapper.class);

    // 显式绑定state字段到status字段的映射关系
    @Mapping(source = "state", target = "status")
    Domain entityToDomain(Entity entity);
}

效果验证 #

修改完成后重新编译项目，触发MapStruct自动生成映射实现类，此时传入Entity { name: "Name", state: "PENDING" }，就会正确转换为Domain { name: "Name", status: "PENDING" }，不会再出现status为null的问题。

内容的提问来源于stack exchange，提问作者Henimbola Tsihala Andrianatoan