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"</string>
与 put 的关键区别
put 总是覆盖旧值，而 putIfAbsent 有“条件写入”语义：
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
-
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); // 后续递增</string>
注意：putIfAbsent 本身不处理“读-改-写”逻辑（比如自增），若需复合操作，应配合 computeIfAbsent 或 merge 使用。
常见误用和注意事项
以下情况容易出错：
- 误以为
putIfAbsent会检查值是否为null—— 它只看键是否存在，与值是否为 null 无关 - 对
HashMap在多线程下直接使用putIfAbsent可能引发数据竞争 —— 应优先选用ConcurrentHashMap - 若需“键不存在或对应值为 null 时才插入”，需手动判断：
if (!map.containsKey(k) || map.get(k) == null)，但要注意并发场景下的竞态
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
