putifabsent()的核心行为是键不存在时插入新值并返回null，存在时返回当前关联值（不覆盖）；其返回值语义是“当前值”而非“是否插入成功”，且在value为null时无法区分插入成功与键已存在且值为null。
Map.putIfAbsent() 的核心行为是什么
putIfAbsent() 会在键不存在时插入新值，存在则不覆盖、直接返回已有值。它不是“条件插入 + 返回布尔值”的判断式 API，而是“尝试插入 + 返回当前值”的语义——这点常被误读。
它的返回值是 Map 中该键**当前关联的值**：如果键原本就存在，返回旧值；如果插入成功，返回 null（前提是 value 允许为 null）；如果 value 本身是 null，且键不存在，则插入 null 并返回 null，此时无法区分“插入成功”和“键已存在且值为 null”。这是最易踩的坑。
什么时候该用 putIfAbsent() 而不是 containsKey() + put()
在并发或高竞争场景下，containsKey() 和 put() 是两步操作，中间可能被其他线程修改，导致覆盖或重复插入。而 putIfAbsent() 是原子操作（对 ConcurrentHashMap 等线程安全实现而言）。
- 单线程下二者效果接近，但
putIfAbsent()更简洁、少一次查找 - 多线程下必须用
putIfAbsent()（配合线程安全 Map），否则竞态不可避免 - 若 Map 是
HashMap，即使加了同步块，containsKey() + put()仍不如直接用putIfAbsent()表达意图清晰
putIfAbsent() 在不同 Map 实现中的表现差异
HashMap、LinkedHashMap 都支持 putIfAbsent()，但它们**不保证线程安全**；ConcurrentHashMap 的 putIfAbsent() 是线程安全的，且只锁住对应 bin，性能远优于全局同步。
-
ConcurrentHashMap.putIfAbsent(k, v)：推荐用于并发场景，失败时不会抛异常，返回旧值 -
HashMap.putIfAbsent(k, v)：非线程安全，但可用于单线程初始化逻辑（如缓存预热） -
TreeMap.putIfAbsent(k, v)：支持，但注意 key 必须可比较，且插入不影响排序逻辑 - 自定义 Map 若未重写该方法，会继承
AbstractMap的默认实现（调用get()+put()），不具备原子性
常见错误写法与修复示例
典型错误是把返回值当“是否插入成功”的布尔标志来用：
if (map.putIfAbsent("key", "newVal") == null) {
// ✅ 错误假设：null = 插入成功 → 实际上也可能是 key 存在且值为 null
}
更稳妥的做法是显式检查是否需要后续处理：
String oldValue = map.putIfAbsent("key", "newVal");
if (oldValue == null) {
// ✅ 插入成功（且确认 value 不为 null）
initializeResource();
} else if (oldValue.equals("expected")) {
// ✅ 已存在且符合预期，跳过
} else {
// ⚠️ 已存在但值不符，可能需告警或 fallback
}
如果 value 可能为 null，又必须区分“首次插入”和“已存在”，建议改用 computeIfAbsent() 或加额外状态标记。
真正容易被忽略的是：putIfAbsent() 不抛异常，也不提供回调，它只做一件事——“不覆盖地塞一个值”。想靠它触发副作用（比如日志、计数、初始化），得自己包裹逻辑，不能指望它自动帮你判断上下文。
