使用Model Mapper映射并写入DTO列表时遇到问题

看起来你遇到的是ModelMapper单条映射正常，但批量列表映射时DTO实例数量正确但字段全为空的问题，我之前也碰到过类似情况，大概率是你的mapAll()工具类函数有问题，咱们一步步排查：

第一步：检查ObjectMapperUtils的mapAll()实现 #

很多复制来的mapAll函数会因为泛型擦除或者实例配置问题导致映射失效，先确认你的方法是不是存在这些问题：

• 错误示例（比如ModelMapper实例未正确初始化，或泛型处理遗漏）：

public static <S, D> List<D> mapAll(List<S> sourceList, Class<D> destinationClass) {
    ModelMapper modelMapper = new ModelMapper(); // 每次新建实例，丢失全局配置
    return sourceList.stream()
        .map(item -> modelMapper.map(item, destinationClass))
        .collect(Collectors.toList());
}

这种写法会导致每次批量映射都新建ModelMapper，之前配置的映射规则、匹配策略都会失效，进而映射出空字段的DTO。

第二步：确认ModelMapper的单例与配置 #

如果单条映射正常，说明基础映射逻辑没问题，但批量映射要注意：

• 确保ModelMapper是单例实例（比如Spring环境下用@Bean注入，工具类通过构造器接收这个单例），避免每次映射都新建实例
• 检查字段匹配策略：如果实体和DTO字段名有差异（比如大小写、驼峰不一致），需要显式配置映射规则，比如：

modelMapper.addMappings(mapper -> {
    mapper.map(UserEntity::getUser_id, UserDto::setUserId);
    mapper.map(UserEntity::getUser_name, UserDto::setUserName);
});

第三步：调试时的关键检查点 #

你提到调试时发现了部分线索，建议重点确认：

• 源列表中的每个实体对象是否真的有非空数据（别排查半天发现源数据本身就是空的😂）
• 在mapAll()的map方法里打断点，看单个实体映射后的DTO是否有数据：如果单个映射就为空，那是单条映射的配置问题（可能之前的单条测试用例刚好字段完全匹配，换了数据就失效）；如果单个映射正常，批量后才空，那大概率是流处理或集合转换时的逻辑错误

修复后的工具类示例 #

给你一个Spring环境下正确的ObjectMapperUtils实现参考：

@Component
public class ObjectMapperUtils {

    private final ModelMapper modelMapper;

    // 构造注入单例ModelMapper
    public ObjectMapperUtils(ModelMapper modelMapper) {
        this.modelMapper = modelMapper;
        // 配置全局匹配策略，比如严格匹配
        this.modelMapper.getConfiguration()
            .setMatchingStrategy(MatchingStrategies.STRICT);
    }

    // 单条映射
    public <S, D> D map(S source, Class<D> destinationClass) {
        return modelMapper.map(source, destinationClass);
    }

    // 批量映射
    public <S, D> List<D> mapAll(List<S> sourceList, Class<D> destinationClass) {
        if (sourceList == null || sourceList.isEmpty()) {
            return Collections.emptyList();
        }
        return sourceList.stream()
            .map(this::map)
            .collect(Collectors.toList());
    }
}

控制器调用验证 #

确保调用时传入的源列表有效，并且工具类已正确注入：

@RestController
@RequestMapping("/users")
public class UserController {

    private final UserRepository userRepository;
    private final ObjectMapperUtils objectMapperUtils;

    public UserController(UserRepository userRepository, ObjectMapperUtils objectMapperUtils) {
        this.userRepository = userRepository;
        this.objectMapperUtils = objectMapperUtils;
    }

    @GetMapping
    public List<UserDto> getAllUsers() {
        List<UserEntity> userEntities = userRepository.findAll();
        return objectMapperUtils.mapAll(userEntities, UserDto.class);
    }
}

如果还是无法解决，建议把你的mapAll()代码、DTO和实体类的字段定义贴出来，这样能更精准定位问题~

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