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中这样编写:
a b - Spring仍然会注入一个普通的
ArrayList,而不是Collections.unmodifiableList(...)的包装版本。
这意味着什么?注入之后,如果业务代码中调用了list.add(...),并不会报错——它确实是可变的。
想要不可变集合?得手动包装
在实际开发中,如果希望注入的集合不可修改,就需要在Bean初始化阶段进行一些处理。常见的方法有两种:
- 在setter方法里封装:
public void setRoles(Listroles) { 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注入的只是数据,而“数据是否可变”,完全取决于你如何持有它、如何暴露它。
