Spring Boot使用@ConfigurationProperties时如何让@Value省略配置前缀

你报错的核心原因是混淆了@ConfigurationProperties和@Value的作用边界：

• @ConfigurationProperties(prefix = "com.abc")仅负责以com.abc为根，自动将Spring Environment中同层级的配置绑定到当前类的同结构字段上，完全不会修改@Value的占位符解析规则。
• @Value的占位符是直接从Environment中查找完整配置key，你写的${cpuUtilization.okThreshold}在Environment中不存在（完整key为com.abc.cpuUtilization.okThreshold），自然会抛出无法解析的异常。

你既然已经添加了@ConfigurationProperties注解，完全不需要再用@Value做手动注入，这就是Spring为多配置项绑定设计的专用注解，只是用法搞错了。

直接复用@ConfigurationProperties的自动绑定能力，不需要任何@Value注解，对应你现有的层级配置com.abc.cpuUtilization.okThreshold = 0.5，有两种实现方式：

方案1：完全匹配现有层级配置（无需修改配置文件） #

用嵌套类对应配置的层级结构，实现零改动适配原有配置：

@Component
@ConfigurationProperties(prefix = "com.abc")
public class SystemConfiguration {
    // 对应配置中的cpuUtilization节点
    private CpuUtilization cpuUtilization = new CpuUtilization();

    // 外层字段的getter/setter
    public CpuUtilization getCpuUtilization() {
        return cpuUtilization;
    }
    public void setCpuUtilization(CpuUtilization cpuUtilization) {
        this.cpuUtilization = cpuUtilization;
    }

    // 静态嵌套类，对应cpuUtilization节点下的属性
    public static class CpuUtilization {
        // 对应配置中的cpuUtilization.okThreshold
        private Double okThreshold;

        // 嵌套类字段的getter/setter
        public Double getOkThreshold() {
            return okThreshold;
        }
        public void setOkThreshold(Double okThreshold) {
            this.okThreshold = okThreshold;
        }
    }
}

Spring会自动按照指定前缀，将对应层级的配置值绑定到嵌套类的字段上，无需任何手动注入操作。其他业务类需要使用该配置时，直接注入SystemConfiguration Bean调用对应get方法即可。

方案2：扁平字段映射（更简洁，需小幅调整配置） #

如果你希望类中直接使用扁平的cpuUtilizationOkThreshold字段，可以利用@ConfigurationProperties的松散绑定规则，将配置文件调整为扁平的中划线格式：

# 原层级配置改为扁平的中划线格式（松散绑定自动适配驼峰字段）
com.abc.cpu-utilization-ok-threshold = 0.5

此时配置类的写法会非常简洁：

@Component
@ConfigurationProperties(prefix = "com.abc")
public class SystemConfiguration {
    // 松散绑定会自动匹配cpu-utilization-ok-threshold到该驼峰字段
    private Double cpuUtilizationOkThreshold;

    // getter/setter
    public Double getCpuUtilizationOkThreshold() {
        return cpuUtilizationOkThreshold;
    }
    public void setCpuUtilizationOkThreshold(Double cpuUtilizationOkThreshold) {
        this.cpuUtilizationOkThreshold = cpuUtilizationOkThreshold;
    }
}

如果你确实有特殊场景必须使用@Value，不建议为了少写前缀去修改Spring的占位符解析逻辑（反而会引入不必要的复杂度），这种场景下要么写完整的配置key，要么直接复用上述@ConfigurationProperties的实现即可——本身你添加了前缀注解的情况下，再混用@Value就是冗余写法。

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