Spring Boot中@DefaultValue注解如何为Map类型配置默认值？

针对你用@ConstructorBinding实现不可变配置类时，Map类型无法通过@DefaultValue设置默认值的问题，有两种可靠的解决方案，且不会影响配置元数据的生成：

方案1：使用JSON字符串作为@DefaultValue的值 #

Spring Boot的配置绑定器支持将JSON格式的字符串直接解析为Map类型，这是兼容性最好的方式，适用于Spring Boot 2.2及以上版本：

@ConfigurationProperties(prefix = "my.app")
@ConstructorBinding
public class AppConfig {

    private final Map<String, String> featureFlags;

    // 用JSON字符串定义Map默认值
    public AppConfig(
            @DefaultValue("{\"auto-refresh\": \"true\", \"debug-mode\": \"false\"}")
            Map<String, String> featureFlags) {
        this.featureFlags = featureFlags;
    }

    // 仅提供Getter，保持类不可变
    public Map<String, String> getFeatureFlags() {
        return featureFlags;
    }
}

这种方式的优势：

• 无需在构造函数内做空值检查，Spring会自动将JSON字符串解析为Map并注入
• 配置元数据生成器能正确识别@DefaultValue中的内容，生成包含默认值的元数据文档
• 支持复杂Map结构（比如值为嵌套对象的Map），只要JSON格式合法即可

方案2：使用SpEL表达式创建Map字面量 #

如果偏好SpEL语法，确保Spring Boot版本在2.4及以上（SpEL的Map字面量支持更稳定），可以直接用SpEL内联Map：

@ConfigurationProperties(prefix = "my.app")
@ConstructorBinding
public class AppConfig {

    private final Map<String, Integer> rateLimits;

    // 用SpEL定义Map默认值
    public AppConfig(
            @DefaultValue("#{{'api': 100, 'admin': 500}}")
            Map<String, Integer> rateLimits) {
        this.rateLimits = rateLimits;
    }

    public Map<String, Integer> getRateLimits() {
        return rateLimits;
    }
}

注意：如果之前尝试SpEL失败，可能是写法错误——Java字符串中嵌套单引号无需转义，直接使用{'key':'value'}格式即可，Spring会正确解析为Map。

前置注意事项 #

1. 确保主类上添加了@ConfigurationPropertiesScan注解，或者用@EnableConfigurationProperties(AppConfig.class)显式启用配置类
2. 必须使用Spring Boot 2.2及以上版本，@ConstructorBinding在该版本后才正式支持不可变配置类

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