在进行 put 操作时，是直接覆盖旧值还是忽略操作有何不同？

本文共计587个文字，预计阅读时间需要3分钟。

在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 更高效