MultiValuedMap的核心价值是天然支持一键多值映射，自动处理空值初始化与集合追加，避免手动判空、新建列表和add操作；适用于日志解析、表单归类等分组收集场景，支持Stream链式处理，并可通过SetValuedMap等变体满足去重与有序需求。
多值 map（如 apache commons collections 中的 multivaluedmap）的核心价值，是把“一个键对应多个值”的映射关系天然结构化，避免手动维护 map<k list>></k> 的重复初始化、空列表检查和 add 操作。它让“一键抽取多个变量值”的逻辑从易错、啰嗦变成一行声明、两行填充、一行读取。
用 MultiValuedMap 替代手写 Map<K, List<V>>
传统方式需反复判空、新建列表、add 元素，容易遗漏或出错；而 MultiValuedMap 自动为新键创建集合容器，调用 put(key, value) 即可追加，无需关心底层是否已存在该 key 对应的 list。
-
不推荐：每次 put 前都得写
map.computeIfAbsent(k, k -> new ArrayList()).add(v) -
推荐：直接
multiMap.put("user_id", "1001"); multiMap.put("user_id", "1002"); - 底层自动聚合为
{"user_id": ["1001", "1002"]}，读取时multiMap.get("user_id")直接返回List
批量提取多个字段的关联值（如日志解析、表单归类）
当原始数据是一组扁平记录（如日志行、HTTP 参数、CSV 行），需按某字段分组并收集其他字段值时，MultiValuedMap 天然适配。
- 例如解析访问日志：按
ip分组，收集所有uri：ipToUris.put(log.ip(), log.uri()) - 再比如处理前端提交的多选参数：
formParams.put("tag", "java"); formParams.put("tag", "spring");，后续直接formParams.get("tag")获取全部选中标签 - 相比循环 + if 判断 + 手动 list.add，代码更聚焦业务意图，不易漏掉边界情况
配合 Java Stream 实现链式聚合与转换
MultiValuedMap 支持直接获取 asMap()（返回 Map<k collection>></k>），可无缝接入 Stream 流式处理，实现“分组 → 聚合 → 映射”一体化。
- 例如统计每个状态下的订单 ID 列表，并转成逗号分隔字符串：
multiMap.asMap().entrySet().stream().collect(Collectors.toMap(Map.Entry::getKey, e -> String.join(",", e.getValue()))) - 也可结合
transformedMap或自定义 Collector 进一步压缩为Map<string set>></string>等变体 - 避免中间生成冗余的
new HashMap()和嵌套 for 循环
注意 key 冲突与值去重场景的选型
MultiValuedMap 默认允许重复值（如多次 put 同一 key-value 对），若需去重，优先选用 SetValuedMap（底层用 Set 存值）；若需有序且唯一，可用 ListValuedMap 配合 LinkedHashSet 包装。
- 普通去重需求：用
MultiValuedMap.createSetBased()或new SetValuedHashMap() - 保持插入顺序 + 去重：用
new SetValuedHashMap(new LinkedHashMap()) - 不要在运行时手动对
get(key)返回的 list 做new HashSet(list)—— 这会丢失原设计意图，也影响性能
