MapStruct中conditionQualifiedByName未生效，求修复及替代方案

你遇到的问题是MapStruct未触发conditionQualifiedByName指定的空值校验，直接执行了toGender转换方法。以下是具体修复方案和替代实现：

修复方案1：确保父类条件方法被正确识别 #

MapStruct对继承的@Condition方法需要显式声明依赖，即使已经继承父类，也可以通过uses属性帮助框架识别父类中的方法：

@Mapper(uses = BaseMapper.class)
public abstract class EmployeeMapper extends BaseMapper {

    @Mappings({
        @Mapping(
            source = "gender", 
            target = "gender", 
            conditionQualifiedByName = "isStringNotNullOrEmpty", 
            qualifiedByName = "toGender"
        )
    })
    public abstract Target transformSource(Source employee);
}

同时确保：

• BaseMapper中的isStringNotNullOrEmpty方法为非private（你的代码已满足）
• 方法参数类型与源字段gender的String类型完全匹配

修复方案2：自定义映射方法手动控制逻辑 #

如果继承方式不生效，直接在Mapper中编写包含校验逻辑的自定义映射方法：

@Mapper
public abstract class EmployeeMapper {

    @Mappings({
        @Mapping(source = "gender", target = "gender", qualifiedByName = "mapGender")
    })
    public abstract Target transformSource(Source employee);

    @Named("mapGender")
    protected String mapGender(String gender) {
        if (StringUtils.isNotEmpty(gender)) {
            return toGender(gender); // 调用你的性别转换方法
        }
        return null; // 校验不通过时不赋值，返回null或按需处理
    }

    // 你的toGender转换方法（若在父类可保留继承）
    @Named("toGender")
    protected String toGender(String gender) {
        // 转换逻辑实现
    }
}

修复方案3：简化条件方法引用 #

如果仅需这一个校验逻辑，可直接用condition属性指定方法，替代conditionQualifiedByName：

public class BaseMapper {
    public boolean isStringNotNullOrEmpty(String input) {
        return StringUtils.isNotEmpty(input);
    }
}

@Mapper(uses = BaseMapper.class)
public abstract class EmployeeMapper {

    @Mappings({
        @Mapping(
            source = "gender", 
            target = "gender", 
            condition = "isStringNotNullOrEmpty", 
            qualifiedByName = "toGender"
        )
    })
    public abstract Target transformSource(Source employee);
}

额外建议 #

如果使用的是MapStruct 1.5.x版本，建议升级到最新稳定版（如1.6.2.Final），新版本修复了不少继承和Builder模式下的条件映射bug。

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