使用MapStruct的@MapMapping转换Map遇类型映射错误，求解决方案

这个问题我之前在项目里也碰到过，核心原因是MapStruct默认只支持已知的类型转换规则：当你把String转Object时，因为String是Object的子类，向上转型是自动的，所以toEntity系列方法能正常生成；但反过来把Object转String，MapStruct找不到默认的转换逻辑，就会抛出你看到的错误。

下面给你几个优雅的解决方案，不用手动写抽象类实现：

方案1：在Mapper接口中添加自定义转换方法 #

直接在MapperThings接口里定义一个Object转String的默认方法，MapStruct会自动识别并使用这个方法处理Map的key和value转换：

@Mapper(componentModel = "spring")
public interface MapperThings {
    // 自定义Object转String的转换逻辑，处理null情况
    default String objectToString(Object value) {
        return value != null ? value.toString() : null;
    }

    // 修正@MapMapping的目标类型为String（之前写的Object.class是多余的）
    @MapMapping(keyTargetType = String.class, valueTargetType = String.class)
    Map<String, String> toDto(Map<Object, Object> mapEntity);

    List<Map<String, String>> toListDto(Collection<Map<Object, Object>> listEntity);

    @MapMapping(keyTargetType = Object.class, valueTargetType = Object.class)
    Map<Object, Object> toEntity(Map<String, String> mapDto);

    List<Map<Object, Object>> toListEntity(Collection<Map<String, String>> listDto);
}

这个方案最简洁，不需要额外创建类，适合简单的转换逻辑。

方案2：使用自定义Converter类 #

如果你的转换逻辑比较复杂（比如需要处理不同类型的Object），可以单独写一个Converter类，然后通过uses属性注册到Mapper中：

// 自定义转换器
public class ObjectToStringConverter implements Converter<Object, String> {
    @Override
    public String convert(Object source) {
        if (source == null) {
            return null;
        }
        // 可以在这里扩展更复杂的转换逻辑，比如判断source的类型
        return source.toString();
    }
}

// 在Mapper中注册转换器
@Mapper(componentModel = "spring", uses = ObjectToStringConverter.class)
public interface MapperThings {
    @MapMapping(keyTargetType = String.class, valueTargetType = String.class)
    Map<String, String> toDto(Map<Object, Object> mapEntity);

    // 其他方法保持不变...
}

这种方式更灵活，适合需要复用转换逻辑的场景。

关键注意点 #

• 你之前的@MapMapping中写keyTargetType = Object.class是错误的，因为目标Map的key类型是String，必须指定keyTargetType = String.class，这样MapStruct才知道要把Object转成String。
• 无论哪种方案，都要处理null值，避免运行时抛出空指针异常。

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