AtomicReference仅保证引用替换原子性，不保护对象内部字段；安全更新需业务对象不可变+整体替换+CAS循环。
Java 中的 AtomicReference 本身不提供“更新复杂业务对象内部字段”的能力，它只保证引用替换这一操作的原子性。所谓“通过泛型安全地更新复杂业务对象”，核心不是泛型本身起作用，而是泛型配合不可变设计和整体替换逻辑，才能实现语义上安全、线程一致的状态变更。
泛型只是类型检查工具，不是线程安全保证
AtomicReference 要让 AtomicReference 对复杂业务对象生效，必须让对象本身支持“状态演进即创建新实例”：
例如：
AtomicReference<order></order> 能确保你 set 一个新 Order 实例是原子的；status 字段是不是被多个线程同时修改；order.setStatus(...)，那 AtomicReference 就形同虚设。真正“安全更新”的前提是业务对象不可变
final；withStatus(...)、withAmount(...) 这样的工厂方法，返回新实例；ImmutableList.copyOf() 或 List.of()）。public final class Order {
public final String id;
public final OrderStatus status;
public final BigDecimal amount;
public Order(String id, OrderStatus status, BigDecimal amount) {
this.id = id;
this.status = status;
this.amount = amount;
}
public Order withStatus(OrderStatus newStatus) {
return new Order(this.id, newStatus, this.amount);
}
}
更新逻辑必须用 CAS 循环或 updateAndGet
不能靠一次 set() 完事，因为新状态依赖当前值。正确做法是：
- 读取当前引用；
- 基于它计算出新对象（不是修改旧对象）；
- 用 compareAndSet 尝试原子替换；
- 失败则重试（或用 Java 8+ 的
updateAndGet自动处理）。
推荐写法（简洁且内置重试）：
AtomicReference<Order> orderRef = new AtomicReference<>(new Order("ORD-001", CREATED, of("99.99")));
// 原子更新状态
Order updated = orderRef.updateAndGet(order ->
order.status == CREATED ? order.withStatus(PROCESSING) : order
);
避免常见误用陷阱
以下操作会破坏安全性，即使泛型写对了也没用：
- 传入可变对象后还在外部修改其字段；
- compareAndSet 时传入 new 出来的“内容相同但地址不同”的对象作预期值；
- 忽略 ABA 问题（如状态从 PROCESSING → DONE → PROCESSING，CAS 会误判成功）；
- 初始化为 null，后续未做空判断就调用 get().xxx() 导致 NPE。
