Spring Boot 2中环境变量覆盖application.properties变量的异常行为

兄弟，我帮你捋清楚Spring Boot 2里用环境变量覆盖配置的关键点，你提到的操作步骤我先补全整理，再说说容易踩的坑：

你的操作回顾 #

1. 在src/main/resources/application.properties中配置两个变量：

   my.prop = hello
   myProp = hello
   

2. 创建src/main/java/me/Main.java（补全你没写完的注入和日志打印部分）：

   import org.springframework.boot.SpringApplication;
   import org.springframework.boot.autoconfigure.SpringBootApplication;
   import org.springframework.beans.factory.annotation.Value;
   import org.springframework.stereotype.Component;
   import org.slf4j.Logger;
   import org.slf4j.LoggerFactory;
   import javax.annotation.PostConstruct;
   
   @SpringBootApplication
   public class Main {
       private static final Logger logger = LoggerFactory.getLogger(Main.class);
   
       public static void main(String[] args) {
           SpringApplication.run(Main.class, args);
       }
   
       @Component
       static class ConfigReader {
           @Value("${my.prop}")
           private String myPropDot;
   
           @Value("${myProp}")
           private String myPropCamel;
   
           @PostConstruct
           public void logProps() {
               logger.info("my.prop value: {}", myPropDot);
               logger.info("myProp value: {}", myPropCamel);
           }
       }
   }
   

核心问题：Spring Boot的环境变量命名规则 #

你可能以为直接设置和配置项同名的环境变量就能覆盖，但Spring Boot对环境变量的解析有特定规则，而且不同的绑定方式（@Value vs @ConfigurationProperties）行为不一样：

1. 针对@Value的严格绑定

@Value是严格匹配属性名的，大小写敏感。而Spring Boot解析环境变量时会做两个转换：

• 把环境变量名转成小写
• 把下划线_替换成点.

举个例子：

• 要覆盖my.prop，你不能直接设置my.prop（操作系统环境变量不允许含点），而是要设置环境变量MY_PROP——解析后会变成my.prop，正好匹配@Value("${my.prop}")
• 要覆盖myProp，对应的环境变量应该是MYPROP，但解析后是myprop，和myProp大小写不同，所以**@Value("${myProp}")无法被MYPROP覆盖**！这是很容易踩的坑。

2. 推荐用@ConfigurationProperties做宽松绑定

如果想避免命名转换的麻烦，推荐使用@ConfigurationProperties——它支持宽松绑定，不管是点分隔、驼峰还是下划线大写的环境变量，都能匹配到对应的配置项。

比如改写成这样：

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import javax.annotation.PostConstruct;
import org.springframework.beans.factory.annotation.Autowired;

@SpringBootApplication
public class Main {
    private static final Logger logger = LoggerFactory.getLogger(Main.class);

    @Autowired
    private MyProperties myProperties;

    public static void main(String[] args) {
        SpringApplication.run(Main.class, args);
    }

    @PostConstruct
    public void logProps() {
        logger.info("my.prop (via ConfigurationProperties): {}", myProperties.getProp());
        logger.info("myProp (via ConfigurationProperties): {}", myProperties.getPropCamel());
    }

    @Component
    @ConfigurationProperties(prefix = "my")
    static class MyProperties {
        // 对应application.properties里的my.prop，或环境变量MY_PROP
        private String prop;
        // 对应application.properties里的myProp，或环境变量MY_PROP_CAMEL
        private String propCamel;

        // Getter和Setter必须有，否则无法绑定
        public String getProp() {
            return prop;
        }

        public void setProp(String prop) {
            this.prop = prop;
        }

        public String getPropCamel() {
            return propCamel;
        }

        public void setPropCamel(String propCamel) {
            this.propCamel = propCamel;
        }
    }
}

这时候你设置环境变量MY_PROP=hello-from-env，就能直接覆盖application.properties里的my.prop=hello；设置MY_PROP_CAMEL=hello-camel-from-env，就能覆盖myProp=hello。

实操验证 #

• Linux/macOS下设置环境变量并启动：

  export MY_PROP=hello-env
  java -jar your-app.jar
  

• Windows下设置环境变量并启动：

  set MY_PROP=hello-env
  java -jar your-app.jar
  

启动后就能看到日志里的配置值已经被环境变量覆盖了。

总结 #

1. 用@Value时，必须严格对应环境变量的解析结果，点分隔的配置对应下划线大写的环境变量；驼峰配置的环境变量匹配很麻烦，不推荐。
2. 优先用@ConfigurationProperties，它的宽松绑定能帮你省去命名转换的烦恼，更适合环境变量覆盖的场景。
3. 记住：操作系统环境变量不支持点，所以必须用下划线+大写的形式来设置。

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