基于Java Stream API实现CollectionUtils遇编译错误，求解决及替代库

先解决你的代码编译错误 #

你当前的代码存在几个核心问题，导致编译失败和功能不符合预期：

1. 类型不匹配：Collectors.toMap返回的是Map<K, V>，但你声明的返回类型是Map<K, List<V>>，类型完全不兼容；
2. 原始类型警告：Collector c未指定泛型，会触发编译警告并导致类型推断错误；
3. 重复Key问题：默认toMap不支持重复Key，遇到相同Key会直接抛出异常，不符合你一对多映射的需求。

正确的实现应该使用Collectors.groupingBy配合Collectors.mapping，这是Java Stream API原生支持的写法，无需额外库：

import java.util.List;
import java.util.Map;
import java.util.function.Function;
import java.util.stream.Collectors;

public class CollectionUtils {
    public static <T, K, V> Map<K, List<V>> listToMap(List<T> inputList,
            Function<? super T, ? extends K> keyMapper,
            Function<? super T, ? extends V> valueMapper) {
        // groupingBy按Key分组，mapping将每个元素转换为目标Value，最终收集为List
        return inputList.stream()
                .collect(Collectors.groupingBy(
                        keyMapper,
                        Collectors.mapping(valueMapper, Collectors.toList())
                ));
    }

    public void test() {
        // 此时可以正常得到Map<String, List<String>>类型的结果
        listToMap(StudentDatabase.getAllStudents(), Student::getName, Student::getActivites);
    }
}

第三方库替代方案 #

如果不想自己实现，这些基于Java Stream的成熟库可以直接解决问题：

• Guava：通过Multimaps.index快速构建一对多映射，支持直接转换为标准Map<K, List<V>>：

  import com.google.common.collect.Multimaps;
  // 构建Multimap，再转为标准Map
  Map<String, List<String>> studentActivities = 
          Multimaps.index(StudentDatabase.getAllStudents(), Student::getName)
                  .asMap();
  

• Apache Commons Collections：使用MultiValuedMap和MapUtils实现分组：

  import org.apache.commons.collections4.MapUtils;
  import org.apache.commons.collections4.MultiValuedMap;
  // 直接分组并收集为MultiValuedMap，也可以转为标准Map
  MultiValuedMap<String, String> multiMap = MapUtils.multiValueMap(
          StudentDatabase.getAllStudents().stream()
                  .collect(Collectors.groupingBy(Student::getName, Collectors.mapping(Student::getActivites, Collectors.toList())))
  );
  

• Eclipse Collections：提供专门的Stream收集器工具类Collectors2，简化分组转换：

  import org.eclipse.collections.impl.collector.Collectors2;
  Map<String, List<String>> studentActivities = 
          StudentDatabase.getAllStudents().stream()
                  .collect(Collectors2.groupBy(
                          Student::getName,
                          Collectors.mapping(Student::getActivites, Collectors2.toList())
                  ));
  

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