使用Mapstruct @ObjectFactory时属性映射失败，请求技术排查

你遇到的这个报错，本质是MapStruct在生成映射代码时，没识别到你通过@ObjectFactory定义的List<UserAddress>和PostalAddress之间的转换逻辑，反而默认要求你声明常规的集合转单对象/单对象转集合的映射方法。

问题根源 #

MapStruct对集合和单个对象的转换有默认处理逻辑：它会优先寻找同类型的集合映射方法，而@ObjectFactory主要用于自定义目标对象的实例创建过程（比如需要依赖注入初始化复杂对象），但在这种跨类型（集合→单实体、单实体→集合）的场景下，MapStruct不会自动关联你的@ObjectFactory方法，所以才会抛出找不到映射方法的错误。

解决方案 #

我们可以通过显式声明转换方法+名称匹配的方式，让MapStruct识别到你的自定义转换逻辑，具体分两步：

1. 修改映射器，声明转换方法并关联自定义实现

在ScimUserMapper中添加对应的转换方法声明，并用qualifiedByName指定要使用的自定义方法名称：

@Mapper(componentModel = "spring", uses = { AddressFactory.class })
public interface ScimUserMapper {

    @Mapping(target = "postalAddress", source = "addresses", qualifiedByName = "toPostalAddress")
    User toUser(ScimUser scimUser);

    @Mapping(target = "addresses", source = "postalAddress", qualifiedByName = "toUserAddressList")
    ScimUser toScimUser(User user);

    // 声明转换方法，给MapStruct提供类型转换的入口
    @Named("toPostalAddress")
    PostalAddress mapListToPostalAddress(List<UserAddress> addresses);

    @Named("toUserAddressList")
    List<UserAddress> mapPostalAddressToList(PostalAddress address);
}

2. 给AddressFactory的方法添加@Named注解

让MapStruct能通过名称匹配到对应的转换逻辑，同时保留@ObjectFactory（如果需要自定义对象创建逻辑的话）：

@Component
public class AddressFactory {

    @Autowired
    private CountryMapper countryMapper;
    @Autowired
    private CountryRepository countryRepository;

    @Named("toPostalAddress")
    @ObjectFactory
    public PostalAddress toPostalAddress(List<UserAddress> addresses, @TargetType Class<PostalAddress> type) {
        // 原有的转换逻辑保持不变
        PostalAddress postalAddress = new PostalAddress();
        if (addresses != null && !addresses.isEmpty()) {
            UserAddress userAddress = addresses.stream().filter(UserAddress::isPrimary).findFirst().orElse(null);
            if (userAddress == null) {
                userAddress = addresses.get(0);
            }
            postalAddress.setAddressLine1(userAddress.getStreetAddress());
            postalAddress.setPostCode(userAddress.getPostalCode());
            postalAddress.setState(userAddress.getRegion());
            postalAddress.setCity(userAddress.getLocality());
            CountryJpa countryJpa = countryRepository.getCountryByIso2Code(userAddress.getCountry());
            if (countryJpa != null) {
                Country country = countryMapper.fromJPA(countryJpa);
                postalAddress.setCountry(country);
            }
        }
        return postalAddress;
    }

    @Named("toUserAddressList")
    @ObjectFactory
    public List<UserAddress> toUserAddressList(PostalAddress address, @TargetType Class<List<UserAddress>> type) {
        // 原有的转换逻辑保持不变
        UserAddress userAddress = new UserAddress();
        userAddress.setCountry(address.getCountry().getIso2());
        userAddress.setFormatted("?");
        userAddress.setLocality(address.getCity());
        userAddress.setPostalCode(address.getPostCode());
        userAddress.setPrimary(true);
        userAddress.setRegion(address.getState());
        userAddress.setStreetAddress(address.getAddressLine1());
        userAddress.setType("?");
        return Collections.singletonList(userAddress);
    }
}

可选简化方案 #

如果你的转换逻辑不需要特别自定义对象创建（比如只是简单的数据转换），也可以去掉@ObjectFactory，直接用常规的映射方法：

@Component
public class AddressFactory {

    @Autowired
    private CountryMapper countryMapper;
    @Autowired
    private CountryRepository countryRepository;

    @Named("toPostalAddress")
    public PostalAddress toPostalAddress(List<UserAddress> addresses) {
        // 原逻辑不变，去掉@TargetType参数
    }

    @Named("toUserAddressList")
    public List<UserAddress> toUserAddressList(PostalAddress address) {
        // 原逻辑不变，去掉@TargetType参数
    }
}

这样修改后，MapStruct就能正确识别到你定义的跨类型转换逻辑，生成对应的映射代码了。

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