Map.put(K,V)默认覆盖旧值，有则更新、无则插入，返回被替换的旧值（或null），不判断插入成功与否；避免覆盖应使用putIfAbsent等语义明确的方法。

put 操作默认覆盖旧值，不是跳过

Java 中 Map.put(K, V) 的行为是“有则更新、无则插入”，它不会跳过，也不会报错，而是强制覆盖同 key 对应的旧 value。无论旧值是否为 null，只要 key 存在，新 value 就会写入，旧值被顶替。

覆盖带来的直接影响

• 旧数据丢失：原 value 被彻底替换，除非你提前用 get(key) 或接收 put 返回值保存，否则无法找回
• 返回值反映历史状态：put 返回的是被替换的旧值（或 null），不是操作结果的真假判断——这常被误读为“是否插入成功”
• 并发下不安全：若先 containsKey 再 put 来模拟“不覆盖”，在多线程中会出现竞态条件（check-then-act 问题）
• LinkedHashMap 等有副作用：覆盖操作可能触发内部节点重排（如 accessOrder=true 时），影响迭代顺序

想避免覆盖？得换方法

如果业务逻辑要求“存在时不覆盖”，不能依赖 put，而应选用语义明确的替代方案：

• putIfAbsent(key, value)：仅当 key 不存在时插入，存在则跳过，返回原值（或 null）
• computeIfAbsent(key, mappingFunction)：key 不存在才计算并放入，适合延迟初始化场景
• Redis 场景用 SETNX 或 HSETNX：原子性地实现“不存在才设值”，避免覆盖

常见误用与建议

• 别用 put 的返回值是否为 null 来判断“是否首次插入”，因为旧值本身可能是 null —— 此时返回 null 无法区分是新增还是覆盖了 null
• 批量导入时慎用 putAll：它对每个重复 key 都执行覆盖，等价于多次 put，不是合并或跳过
• 调试时可打印 put 返回值，快速确认某次写入是否发生了覆盖，比反复 get 更高效