Spring Boot新增配置属性不生效？环境变量等配置无法读取求助

这不是Spring Boot的Bug，也不是功能限制，问题出在配置绑定的字段映射缺失上，以下是具体分析和解决步骤：

核心原因 #

你现有配置类大概率只声明了property1字段，没有对应新增的property2，导致Spring无法将外部传入的配置绑定到类中，最终读取值为null。

比如原配置类可能是这样的：

@ConfigurationProperties(prefix = "config")
public class AppConfig {
    private String property1;

    // 仅包含property1的getter/setter
    public String getProperty1() {
        return property1;
    }

    public void setProperty1(String property1) {
        this.property1 = property1;
    }
}

此时无论通过哪种方式传入config.property2，Spring都找不到对应字段，自然无法完成绑定。

解决步骤 #

1. 更新配置类 #

在配置类中新增property2字段，并补充符合JavaBean规范的getter和setter方法：

@ConfigurationProperties(prefix = "config")
public class AppConfig {
    private String property1;
    private String property2; // 新增属性字段

    // property1的getter/setter
    public String getProperty1() {
        return property1;
    }

    public void setProperty1(String property1) {
        this.property1 = property1;
    }

    // property2的getter/setter
    public String getProperty2() {
        return property2;
    }

    public void setProperty2(String property2) {
        this.property2 = property2;
    }
}

确保类上已添加@ConfigurationProperties注解，且prefix设置为config（与配置前缀一致）。

2. 确保配置类生效 #

在Spring Boot启动类或配置类上添加@EnableConfigurationProperties注解，启用配置绑定：

@SpringBootApplication
@EnableConfigurationProperties(AppConfig.class)
public class MyApplication {
    public static void main(String[] args) {
        SpringApplication.run(MyApplication.class, args);
    }
}

3. 不同配置方式的注意事项 #

• 环境变量：Linux/macOS环境下需将点号替换为下划线并大写，比如CONFIG_PROPERTY2="some extra value"；Windows环境可直接使用config.property2="some extra value"。
• @TestPropertySource：测试类需搭配@SpringBootTest等能加载Spring上下文的注解，否则配置不会生效。
• 启动命令参数：若属性值包含空格，需用引号包裹，比如java -jar myapp.jar --config.property2="some extra value"。

额外排查点 #

若已添加字段仍读取失败，可检查：

• 配置类、字段及getter/setter的访问修饰符是否为public（符合JavaBean规范）。
• 查看启动日志中ConfigurationProperties相关输出，确认配置类是否被正确加载。
• 确认没有内部配置文件（如application.yml）覆盖外部传入的属性，Spring Boot配置优先级为：命令行参数 > 环境变量 > 内部配置文件。

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