应提前在stream中用filter过滤无效key（null、空字符串、不合规字符），再调用toMap；重复key需按业务意图选择去重、合并或覆盖策略。
使用 Collectors.toMap 构建变量索引时，若源数据中存在无效 key（如 null、空字符串、重复 key 或不满足业务规则的 key），直接调用会抛出异常或覆盖数据。关键在于**在收集前过滤掉无效 key，而非依赖 toMap 的 merge 功能**。
提前过滤：在 stream 中用 filter 剔除无效 key
最安全、最直观的方式是在流式处理的早期阶段就排除掉非法 key。toMap 本身不负责校验 key，所以必须由你主动控制输入质量。
- 检查 key 是否为
null：entry -> entry.getKey() != null - 检查 key 是否为空字符串（针对 String 类型）：
key -> !key.trim().isEmpty() - 检查 key 是否符合命名规范（如只含字母数字下划线）：
key -> key.matches("[a-zA-Z0-9_]+") - 结合多个条件用 && 连接，确保 key 同时满足所有有效要求
避免 null key 导致 NullPointerException
toMap 的 key mapper 函数返回 null 时，JDK 会立即抛出 NullPointerException。这不是运行时数据冲突，而是构造阶段的硬性限制。
- 不要依赖“后面再处理”，null key 必须在 key mapper 执行前消除
- 可使用
Objects.requireNonNullElse(key, "")替换 null，但需配合后续 filter 判空，否则空字符串仍可能成为无效 key - 更稳妥做法是：先 map 出 key，再 filter 掉 null 和空值，最后 toMap
处理重复 key：明确业务意图再选策略
重复 key 不属于“无效 key”范畴，但常被误认为需要过滤。是否保留取决于业务逻辑：
- 若重复 key 表示数据错误，应在 filter 阶段去重（如按 key 取第一个/最后一个）
- 若需合并 value（如累加、拼接），改用
Collectors.groupingBy+ downstream 收集器更清晰 - 若坚持用 toMap 且允许覆盖，可传入第三个参数（merge function），例如
(v1, v2) -> v1保留首个值
完整示例：构建非空、非重复、合法命名的变量索引
假设有一组 Map.Entry<string object></string>，要转成 Map<string object></string> 索引，要求 key 不为 null、不为空白、只含字母数字下划线：
Map<String, Object> index = entries.stream()
.filter(entry -> entry.getKey() != null)
.filter(entry -> !entry.getKey().trim().isEmpty())
.filter(entry -> entry.getKey().matches("[a-zA-Z0-9_]+"))
.collect(Collectors.toMap(
Map.Entry::getKey,
Map.Entry::getValue
));
这样得到的 map 保证 key 全部有效，无异常风险，也无需额外兜底逻辑。
