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

Spring在处理集合注入时，默认生成的是可变集合。想要实现不可变性，开发者需要自己动手封装，比如用Collections.unmodifiableList或List.copyOf。XML配置本身可不会自动给你搞成不可变的。更推荐的做法是构造注入加上final字段，这样能更好地保障不可变语义。

其实，Ja va的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和Ja va 14+的环境下，更自然的做法是：

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

举个例子：

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

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