Spring单例集合本身不线程安全且无自动快照能力，需通过不可变快照（如ImmutableList）或CopyOnWrite容器等应用层模式实现动态刷新时遍历不中断。
Spring 容器托管的单例集合（如 @Bean 返回的 List、Map 等）本身不是线程安全的容器，也不具备自动快照能力。所谓“动态刷新时保障历史遍历不中断”，核心不在 Spring 自身提供机制，而在于你如何设计集合的持有方式与访问契约——快照迭代器（Snapshot Iterator）是一种应用层模式，需主动实现，而非 Spring 内置功能。
理解“单例集合”在 Spring 中的真实语义
Spring 的单例 Bean 指的是：同一个 ApplicationContext 中，该 Bean 实例有且仅有一个。但这个实例如果是一个可变集合（如 ArrayList 或 HashMap），它的内容仍可被任意注入方修改。Spring 不会为它加锁、不拦截写操作、不自动做版本隔离。
- 集合本身是普通 Java 对象，生命周期由 Spring 管理，但并发行为由开发者负责
- “动态刷新”通常指运行时通过事件、配置中心或手动调用方法更新集合内容（如重载白名单、刷新路由规则等）
- 若此时有线程正在遍历旧集合，直接替换引用（如
list = newList）是安全的；但若原地clear()+addAll()，则遍历可能抛ConcurrentModificationException或读到脏数据
用不可变快照替代实时集合引用
最轻量、最可靠的做法：每次刷新时生成一个**不可变快照**，让遍历者持有一份只读副本，与后续刷新完全解耦。
- 使用
java.util.Collections.unmodifiableList(list)或 Guava 的ImmutableList.copyOf(list) - 将快照对象封装进线程安全的容器中，例如：
private final AtomicReference<List<Rule>> currentRules = new AtomicReference<>(ImmutableList.of());
刷新时：currentRules.set(ImmutableList.copyOf(newRules)); - 遍历代码始终从
currentRules.get()获取快照，哪怕刷新瞬间发生，该次遍历看到的仍是完整旧视图
结合 CopyOnWrite 容器做低开销实时更新
适用于读多写少、集合不大、允许短时间内存冗余的场景：
- 用
CopyOnWriteArrayList或CopyOnWriteArraySet托管元素，它们天然支持“读不加锁、写时复制” - 遍历时拿到的是创建迭代器那一刻的数组副本，后续写操作不影响当前迭代
- 注意：不适用于
Map场景（JDK 无CopyOnWriteHashMap），可考虑ConcurrentHashMap+new HashMap(map)手动快照
避免踩坑的关键实践
不要依赖 Spring 的“单例”属性来解决并发安全问题：
- 禁止在 Bean 方法中返回原始可变集合（如
return this.rules;），应返回不可变视图或副本 - 刷新逻辑需保证原子性：先构建新集合，再原子替换引用（推荐
AtomicReference或synchronized块） - 若使用
@EventListener响应配置刷新事件，确保监听器内不直接修改共享集合，而是触发快照切换 - 日志或监控中记录快照版本号（如
System.identityHashCode(snapshot)），便于排查遍历与刷新的时间错位问题
快照不是魔法，是权衡。它用一点内存和一次复制成本，换来了遍历语义的确定性。Spring 不替你做，但给了你干净的 Bean 生命周期和线程上下文，让你能稳稳落地这个模式。
