Spring 5.x中如何为@Value注解的Map设置默认值？

问题原因 #

你之前尝试的几种写法失败的核心原因：

• @Value("#{${test.feature:{T(java.util.Collections).emptyMap()}}}")：当属性未配置时，${test.feature:...}会将默认值作为字符串解析，SpEL无法直接将字符串形式的emptyMap()转换为嵌套Map类型，触发类型转换异常。
• @Value("#{${test.feature} ?: { : }}")：{ : }是单级空Map，与目标类型Map<String, Map<String, String>>不匹配，导致类型不兼容。

可行解决方案 #

方案一：借助Environment判断属性存在性（推荐轻量写法） #

利用Spring的Environment对象先检查属性是否存在，再决定取值，避免未配置时的解析错误：

@Bean
public YourBean yourBean(@Value("#{environment.containsProperty('test.feature') ? ${test.feature} : T(java.util.Collections).emptyMap()}") 
                         Map<String, Map<String, String>> featureMap) {
    return new YourBean(featureMap);
}

原理：通过environment.containsProperty()判断属性是否存在，存在则解析配置的嵌套Map；不存在则返回泛型匹配的空Map，Spring能正确推断类型。

方案二：使用@ConfigurationProperties（更规范的配置管理） #

Spring 5.x原生支持该注解，这种方式配置管理更清晰，默认值设置更直观：

1. 定义配置类，设置默认值：

public class FeatureConfig {
    private Map<String, Map<String, String>> feature = Collections.emptyMap();

    // Getter和Setter
    public Map<String, Map<String, String>> getFeature() {
        return feature;
    }

    public void setFeature(Map<String, Map<String, String>> feature) {
        this.feature = feature;
    }
}

2. 在配置类中启用配置绑定：

@Configuration
@EnableConfigurationProperties(FeatureConfig.class)
@PropertySource("classpath:your-config.properties") // 指向你的properties文件
public class AppConfig {
    @Bean
    public YourBean yourBean(FeatureConfig featureConfig) {
        Map<String, Map<String, String>> featureMap = featureConfig.getFeature();
        return new YourBean(featureMap);
    }
}

3. 修改properties文件的键名（对应配置类的属性）：

feature.feature={UPPER:{id:'54'}}

原理：Spring会自动完成类型转换，当属性未配置时，直接使用配置类中定义的默认空嵌套Map。

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