Spring Boot 中使用 @Value("${key:default}") 设置默认值时，若表达式中存在空格（如 ${key : default}），会导致 Spring 忽略配置文件中的实际值而强制采用默认值；正确写法需严格避免冒号两侧的空格。

spring boot 中使用 `@value("${key:default}")` 设置默认值时，若表达式中存在空格（如 `${key : default}`），会导致 spring 忽略配置文件中的实际值而强制采用默认值；正确写法需严格避免冒号两侧的空格。

在 Spring Boot 应用中，@Value 注解支持从外部配置（如 application.yml 或 application-local.yml）注入属性值，并可通过冒号语法指定默认值。但该语法对格式极其敏感：冒号 : 前后不允许有任何空格。一旦写成 ${apis.maxNumOfCics : 88}，Spring 的占位符解析器会将整个字符串视为字面量（literal），而非可解析的属性表达式，从而跳过配置查找流程，直接返回右侧的默认值 88——即使 application-local.yml 中已正确定义：

# application-local.yml
apis:
  maxNumOfCics: 20

且已通过 spring.profiles.active=local 激活对应 Profile。

✅ 正确写法（无空格）：

@Value("${apis.maxNumOfCics:88}")
private Integer maxNumOfCics;

❌ 错误写法（含空格，触发默认值“硬编码”行为）：

@Value("${apis.maxNumOfCics : 88}") // ← 冒号前后空格导致解析失败
@Value("${apis.maxNumOfCics: 88}") // ← 冒号后空格同样无效
@Value("${apis.maxNumOfCics :88}") // ← 冒号前空格同样无效

? 验证技巧：若移除默认值（即 @Value("${apis.maxNumOfCics}")）后能正常读取 application-local.yml 中的 20，即可确认配置文件、Profile 激活及属性路径均无误，问题必源于 @Value 表达式格式。

此外，推荐结合 @ConfigurationProperties 实现类型安全、可校验的配置绑定（尤其适用于多层级属性），避免 @Value 的局限性：

@Component
@ConfigurationProperties(prefix = "apis")
public class ApiConfig {
    private Integer maxNumOfCics = 88; // 默认值在字段级定义，更清晰可控
    // getter/setter
}

并确保主类或配置类上添加 @EnableConfigurationProperties(ApiConfig.class)（Spring Boot 2.2+ 默认启用，通常无需显式声明）。

总结：@Value 的默认值机制并非“优先回退”，而是“仅当属性完全未解析成功时才生效”。空格破坏了占位符结构，使 Spring 无法识别为有效表达式，从而绕过所有外部配置源。务必保持 ${key:default} 格式紧凑、零空格，方可兼顾灵活性与可靠性。