Spring Record集合/Map类型如何设置空默认值？

1. 用SpEL表达式直接指定空集合默认值 #

这是最简洁的方式，直接在@DefaultValue中通过Spring表达式语言（SpEL）生成空Set实例：

@ConfigurationProperties("dummy")
public record TestRecord(
        @DefaultValue("#{T(java.util.Set).of()}") Set<String> values,
        @DefaultValue("default") String one
) {
}

针对Map类型，同理可以用@DefaultValue("#{T(java.util.Map).of()}")设置空Map默认值。这种方式无需额外代码，直接在注解层完成配置，完全符合Spring Boot配置属性的规范。

2. 利用Record的紧凑构造器统一初始化 #

如果不想依赖SpEL，可以通过Record的紧凑构造器（Compact Constructor）对所有需要默认值的集合属性做统一初始化：

@ConfigurationProperties("dummy")
public record TestRecord(Set<String> values, @DefaultValue("default") String one) {
    // 紧凑构造器，自动处理参数的默认值
    public TestRecord {
        values = values == null ? Set.of() : values;
        // 如果还有其他集合/Map属性，可在此统一处理
        // otherMap = otherMap == null ? Map.of() : otherMap;
    }
}

这种方式把所有默认值逻辑集中在构造器里，避免了重复编写多个访问方法，适合多集合属性的场景。

3. 全局自定义类型转换器（批量处理） #

如果整个项目有大量集合类型的配置属性需要默认空集合，可以自定义一个全局类型转换器，自动将null转换为空集合：

@Component
public class EmptySetConverter implements Converter<String, Set<String>> {
    @Override
    public Set<String> convert(String source) {
        // 若配置未指定值，source为null，直接返回空Set
        return source == null ? Set.of() : Set.of(source.split(","));
    }
}

同理可以编写EmptyMapConverter处理Map类型。这种方式适合项目级别的统一规则，一次配置即可覆盖所有同类属性，但需要注意转换器的适用范围，避免影响其他正常的配置转换逻辑。

内容的提问来源于stack exchange，提问作者Eugene