Java Collections工具类在Spring Bean属性注入不可变集合的应用

Spring在进行集合注入时，默认生成的集合类型是可变的。如果开发者希望获得不可变集合，必须手动进行封装，例如使用Collections.unmodifiableList或List.copyOf。XML配置本身并不会自动创建不可变集合。更推荐的做法是采用构造注入，并将字段声明为final，这样能更有效地保证不可变语义。

实际上，Java的Collections工具类并不直接参与Spring的Bean属性注入过程，它也无法直接生成“Spring可识别的不可变集合”来完成注入。真正发挥作用的，是Spring容器对List、Set、Map等集合类型在XML或注解配置中的支持。而集合的不可变性，则完全需要开发者主动保障——Collections.unmodifiableXXX()只是运行时的一道保护屏障，它本身并非注入机制的一部分。

Spring集合注入，本质上是可变容器

当Spring解析、、这些标签时，底层默认创建的都是标准可变集合，例如ArrayList、LinkedHashSet、LinkedHashMap。即使你在XML中这样编写：

• ab
• Spring仍然会注入一个普通的ArrayList，而不是Collections.unmodifiableList(...)的包装版本。

这意味着什么？注入之后，如果业务代码中调用了list.add(...)，并不会报错——它确实是可变的。

想要不可变集合？得手动包装

在实际开发中，如果希望注入的集合不可修改，就需要在Bean初始化阶段进行一些处理。常见的方法有两种：

• 在setter方法里封装：public void setRoles(List roles) { this.roles = Collections.unmodifiableList(new ArrayList<>(roles)); }
• 在构造函数里封装（推荐）：public UserService(List permissions) { this.permissions = Collections.unmodifiableList(permissions); }。不过需要注意，必须确保传入的permissions是副本，以避免外部仍持有原始引用，否则仍有可能被间接修改。

XML配置没法自动生成不可变集合

Spring的XML集合标签，例如，并没有提供immutable="true"这样的属性，也不支持直接调用Collections.unmodifiableList()这类静态工厂方法。它只负责实例化和填充集合，至于集合运行时的行为如何，它并不干预。

有些人可能会想，在XML中能否这样写：

• ... —— 遗憾的是，这并非标准用法，Spring不会识别这种嵌套的工厂调用，除非你自定义一个FactoryBean。

现代写法：注解 + 构造注入 + 不可变语义

在Spring Boot和Java 14+的环境中，更自然的做法是：

• 使用@AllArgsConstructor或显式编写一个构造函数来接收集合参数
• 将字段声明为final，在构造方法中赋值并进行封装：this.roles = List.copyOf(roles);（Java 10+）或Collections.unmodifiableList(...)
• 结合Lombok的@Builder或直接使用Record类，能够进一步强化不可变契约

举个例子：

public record Config(List endpoints) {
  public Config {
    this.endpoints = List.copyOf(endpoints); // 确保得到的是不可变副本
  }
}

这部分其实并不复杂，但很容易被忽略：不可变性不是靠配置“配置”出来的，而是靠设计“设计”出来的。Spring注入的只是数据，而“数据是否可变”，完全取决于你如何持有它、如何暴露它。