使用Collectors.toMap时，键值预处理应在keyMapper和valueMapper中完成：键需去空格、转小写、防null；值可脱敏或设默认值；冲突时mergeFunction需协同清洗逻辑；mapper须为纯函数，用Optional防御空指针。

使用 Collectors.toMap 时，若希望在映射前对键或值做预处理（比如去空格、转小写、非空校验、默认值填充等），关键在于把清洗逻辑写进 keyMapper 和 valueMapper 函数中，而非依赖外部循环或中间集合。

在 keyMapper 中做键的预清洗

键必须唯一且不可为 null，因此常见清洗包括：去除首尾空白、忽略大小写归一化、替换非法字符、空值兜底等。

例如，将用户邮箱作为键，需统一转小写并过滤 null：

Map<String, User> userMap = users.stream()
    .filter(Objects::nonNull)
    .collect(Collectors.toMap(
        u -> Optional.ofNullable(u.getEmail())
                     .map(String::trim)
                     .map(String::toLowerCase)
                     .orElse("unknown@example.com"),
        Function.identity(),
        (u1, u2) -> u1 // 冲突策略
    ));

在 valueMapper 中做值的预清洗

值可为 null，但若业务要求“空字段转默认值”或“敏感字段脱敏”，就应在 valueMapper 中完成。

比如将用户名脱敏（仅保留首尾字符）：

Map<Long, String> idToMaskedName = users.stream()
    .collect(Collectors.toMap(
        User::getId,
        u -> {
            String name = u.getName();
            if (name == null || name.length() <= 2) return "**";
            return name.charAt(0) + "*" + name.charAt(name.length() - 1);
        }
    ));

组合清洗 + 冲突合并时的协同处理

当清洗后键可能重复（如两个不同邮箱转小写后相同），需在 mergeFunction 中延续清洗逻辑，保持语义一致。

• 例如按部门分组，键为部门名（统一 trim + toLowerCase），冲突时取员工数多的部门对象
• 或清洗后键相同，但值需拼接（如多个别名合并为逗号字符串）

示例：合并同名部门，值为员工列表，并确保部门名已标准化：

Map<String, List<User>> deptMap = users.stream()
    .collect(Collectors.toMap(
        u -> Optional.ofNullable(u.getDept()).map(String::trim).map(String::toLowerCase).orElse("other"),
        Collections::singletonList,
        (list1, list2) -> {
            List<User> merged = new ArrayList<>(list1);
            merged.addAll(list2);
            return merged;
        }
    ));

避免副作用与空指针的实用建议

toMap 的 mapper 函数应是纯函数（无状态、无修改、不抛异常）。预清洗务必防御性处理：

• 用 Optional.ofNullable(...).map(...).orElse(...) 替代直接调用 .trim() 或 .toLowerCase()
• 避免在 mapper 中执行 I/O、数据库查询或复杂计算——这会破坏流的声明式语义和性能
• 若清洗逻辑复用度高，抽成静态方法（如 KeyCleaners.normalizeEmail()），提升可读性与测试性