putIfAbsent 是 Map 接口方法，仅在键不存在时插入键值对，返回当前值（null 表示插入成功）；它不检查值是否为 null，ConcurrentHashMap 中线程安全，而 HashMap 多线程下需避免直接使用。
Java 中 putIfAbsent 是 Map 接口定义的方法，用于**仅在键不存在时才插入键值对**，避免覆盖已有值，线程安全且语义清晰。
方法签名和基本用法
putIfAbsent(K key, V value) 返回当前与键关联的值（如果存在），否则插入新值并返回 null。它适用于所有实现了该方法的 Map 实现，如 HashMap、ConcurrentHashMap 等。
示例：
Map<String, String> map = new HashMap<>();
map.putIfAbsent("name", "Alice"); // 插入成功，返回 null
map.putIfAbsent("name", "Bob"); // 键已存在，不替换，返回 "Alice"
与 put 的关键区别
put 总是覆盖旧值，而 putIfAbsent 有“条件写入”语义：
JavaStoryDevelop
下载
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
立即学习“Java免费学习笔记（深入）”；
-
put(key, value)：不管原来有没有，都设为新值，返回旧值（可能为 null） -
putIfAbsent(key, value)：只在 key 完全不存在时才插入，返回当前值（null 表示插入成功）
在 ConcurrentHashMap 中的线程安全性
当多个线程并发操作时，ConcurrentHashMap.putIfAbsent 是原子操作，无需额外同步：
ConcurrentHashMap<String, Integer> counter = new ConcurrentHashMap<>();
counter.putIfAbsent("request_count", 0); // 首次初始化计数器
counter.computeIfPresent("request_count", (k, v) -> v + 1); // 后续递增
注意：putIfAbsent 本身不处理“读-改-写”逻辑（比如自增），若需复合操作，应配合 computeIfAbsent 或 merge 使用。
常见误用和注意事项
以下情况容易出错：
- 误以为
putIfAbsent会检查值是否为null—— 它只看键是否存在，与值是否为 null 无关 - 对
HashMap在多线程下直接使用putIfAbsent可能引发数据竞争 —— 应优先选用ConcurrentHashMap - 若需“键不存在或对应值为 null 时才插入”，需手动判断：
if (!map.containsKey(k) || map.get(k) == null)，但要注意并发场景下的竞态
