putifabsent 是 java 8 新增的原子插入方法，仅当键未映射（含 null 值映射）时才插入，返回原值（存在）或 null（新增），concurrenthashmap 中天然线程安全。

putIfAbsent 是 Java 8 为 Map 接口新增的安全插入方法，它只在指定键**当前不存在**（即未映射到任何值，包括 null）时才放入键值对，避免覆盖已有值，天然线程安全（对 ConcurrentHashMap）且无需手动判空。

核心行为：仅当键未映射时才插入

该方法签名是：
V putIfAbsent(K key, V value)
它会返回该键**原先关联的值**（如果存在），若键不存在，则插入新值并返回 null。

注意：即使原 Map 中某个键映射到了 null 值（如 map.put("k", null)），putIfAbsent("k", "v") 仍会执行插入 —— 因为 null 被视为“已存在映射”，只是值为 null。这点和 containsKey() 行为一致（都看键是否已注册），但不同于 get() == null 的判断逻辑。

典型使用场景与写法

• 初始化默认值：比如缓存中首次请求某用户配置，只设一次默认值
  configMap.putIfAbsent(userId, new UserConfig());
• 避免重复计算/创建开销：值构造代价高时，确保只建一次
  cache.putIfAbsent(key, expensiveCompute(key));
• 配合返回值做条件判断：利用返回值区分“是新插入”还是“已存在”
  if (map.putIfAbsent(k, v) == null) { /* 确实是首次放入 */ }

和传统方式对比（更简洁、无竞态）

以前常用写法：

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

if (!map.containsKey(key)) {
    map.put(key, value); // 非线程安全 Map 下有竞态风险
}

问题：containsKey 和 put 是两个操作，多线程下可能被其他线程插队修改。而 putIfAbsent 是原子操作（尤其在 ConcurrentHashMap 中），一步到位。

另外，它比下面这种写法更直接：

map.computeIfAbsent(key, k -> value); // 适合需要懒加载 value 的场景

putIfAbsent 更适合你**已经持有要插入的值对象**，不希望重新创建或计算的情况。

注意事项

• 所有标准实现（HashMap、TreeMap、ConcurrentHashMap）都支持该方法
• 传入 null 键或值时，取决于具体 Map 实现（HashMap 允许 null 键，ConcurrentHashMap 不允许 null 键或值）
• 返回值是 V 类型，可直接用于判断：
  V old = map.putIfAbsent(k, v); if (old == null) { /* 新增成功 */ }

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南