Spring Boot中含.和-符号的Map<String, Enum>属性绑定失败如何解决？

可能的原因及修复步骤 #

1. 确认枚举类定义匹配 #

检查SomeEnum的常量名称与配置文件中的值完全一致（Spring Boot枚举绑定默认大小写敏感）：

public enum SomeEnum {
    SOME_ENUM_1,
    SOME_ENUM_2; // 必须与yml配置里的SOME_ENUM_1、SOME_ENUM_2完全匹配
}

2. 激活配置属性扫描 #

在Spring Boot主启动类上添加@ConfigurationPropertiesScan注解，确保Spring能识别你的SomeProperties类：

@SpringBootApplication
@ConfigurationPropertiesScan // 新增该注解
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

若SomeProperties类与主启动类不在同一包/子包下，需指定扫描路径：@ConfigurationPropertiesScan(basePackages = "com.example.config")

3. 简化配置属性类注解 #

移除@Configuration注解（@ConfigurationPropertiesScan已能将该类注册为Bean，避免重复注册问题），保持核心注解即可：

@Getter
@Setter
@ConfigurationProperties(prefix = "app.prefix")
public class SomeProperties {
    private Map<String, SomeEnum> someEnumMappings;
}

4. 自定义枚举转换器（默认绑定失效时用） #

如果默认枚举转换逻辑不满足需求，自定义转换器并注册到Spring容器：

@Component
public class SomeEnumConverter implements Converter<String, SomeEnum> {
    @Override
    public SomeEnum convert(String source) {
        // 可自定义逻辑，比如忽略大小写
        return SomeEnum.valueOf(source.trim().toUpperCase());
    }
}

验证绑定结果 #

注入SomeProperties并打印配置值，确认绑定是否成功：

@RestController
public class TestController {
    private final SomeProperties properties;

    public TestController(SomeProperties properties) {
        this.properties = properties;
    }

    @GetMapping("/test-config")
    public Map<String, SomeEnum> getConfig() {
        return properties.getSomeEnumMappings();
    }
}

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