如何用ModelMapper映射嵌套DTO？AddressDTO全为空的解决办法

我想用ModelMapper把User实体映射到包含AddressDTO属性的UserDTO类，每个用户最多一个地址，所以AddressDTO允许为空，但现在用ModelMapper时所有用户的AddressDTO都是空的。

最初我手动通过构造方法映射DTO（能正常获取AddressDTO）：

private UserDTO mapToUserDTO(User user){
    UserDTO userDTO = new UserDTO();

    userDTO.setId(user.getId());
    userDTO.setUsername(user.getUsername());
    userDTO.setEmail(user.getEmail());
    userDTO.setIsActive(user.getIsActive());

    Address address = addressRepository.findAddressByUser(user);
    if (address == null)
        userDTO.setAddress(null);
    else {
        AddressDTO addressDTO = mapper.mapToDTO(address, AddressDTO.class);
        userDTO.setAddress(addressDTO);
    }
    return userDTO;
}

之后改用ModelMapper自动映射，AddressDTO全部为空：

public DataResponse<List<UserDTO>> getAll() {
    List<User> users = userRepository.findAll();
    List<UserDTO> userDTOs = userMapper.mapToDTOList(users, UserDTO.class);

    return new DataResponse<>(userDTOs);
}

我的抽象映射类AbstractModelMapper：

public class AbstractModelMapper <E,D>{
    @Autowired
    ModelMapper mapper;

    public D mapToDTO(E e, Class<D> d){ return e != null ? mapper.map(e,d) : null;}

    public E mapToEntity(D d, Class<E> e){ return d!= null ? mapper.map(d, e) : null;}

    public List<D> mapToDTOList(List<E> eList, Class<D> d){
        return eList != null ? eList.stream().map(e -> mapper.map(e,d)).collect(Collectors.toList()) : null;
    }
}

UserMapper实现：

@Component
public class UserMapper extends AbstractModelMapper<User, UserDTO> {
}

通过依赖注入使用：

@Autowired
UserMapper userMapper;

请问怎么解决AddressDTO为空的问题？需要创建特定配置类吗？

AddressDTO为空的核心原因通常是实体关联未加载或ModelMapper缺少映射规则配置，按以下步骤排查解决：

1. 修复User实体的Address关联加载问题 #

手动映射时你是主动调用addressRepository查询地址，但ModelMapper是直接读取User实体的address属性。如果User的address是懒加载关联（JPA默认），调用userRepository.findAll()时不会自动加载地址，导致实体中address为null，映射后的AddressDTO自然为空。

解决方法：
修改UserRepository，添加带关联加载的查询方法：

@Query("SELECT u FROM User u LEFT JOIN FETCH u.address")
List<User> findAllWithAddress();

然后在业务方法里调用findAllWithAddress()替代findAll()。

2. 配置ModelMapper的映射规则 #

如果实体和DTO的字段名存在差异，或者需要显式指定关联映射逻辑，需要给ModelMapper添加自定义配置。

创建ModelMapper配置类，注册为Spring Bean：

@Configuration
public class ModelMapperConfig {

    @Bean
    public ModelMapper modelMapper() {
        ModelMapper modelMapper = new ModelMapper();
        
        // 显式配置User到UserDTO的address属性映射
        modelMapper.createTypeMap(User.class, UserDTO.class)
                .addMapping(User::getAddress, UserDTO::setAddress);
        
        // 若Address和AddressDTO字段名不匹配，需补充对应映射规则
        modelMapper.createTypeMap(Address.class, AddressDTO.class)
                .addMapping(Address::getStreet, AddressDTO::setStreet)
                .addMapping(Address::getCity, AddressDTO::setCity);
        
        return modelMapper;
    }
}

3. 确保配置生效 #

你的AbstractModelMapper已经通过@Autowired注入ModelMapper，只要配置类正确注册，Spring会自动注入配置好的实例，无需修改现有映射类代码。

额外排查点 #

• 确认User实体有getAddress()方法，UserDTO有setAddress(AddressDTO)方法，ModelMapper依赖getter/setter完成映射。
• 检查Address实体和AddressDTO的字段名是否匹配，若有差异需在配置类中补充映射规则。

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