Docker向Spring Boot应用传递环境变量失败问题排查

嘿，我一眼就瞅出问题在哪了！你的Docker运行命令参数顺序搞错啦——这才是环境变量没生效的核心原因。

Docker的docker run命令有严格的参数顺序：docker run [OPTIONS] IMAGE [COMMAND] [ARG...]。你把-e TEST_VAR='testing'放在了镜像名my-image后面，这会被Docker当成容器启动时要执行的命令参数，而不是用来设置环境变量的选项，所以Spring Boot完全读不到这个变量。

正确的Docker运行命令 #

把环境变量选项移到镜像名前面就行：

docker run -e TEST_VAR='testing' my-image

额外的环境变量传递技巧 #

如果有多个环境变量要传递，还有更方便的方式：

• 使用--env-file加载环境变量文件：
  先创建一个.env文件，把变量写进去：

  TEST_VAR=testing
  ANOTHER_VAR=hello-world
  

  然后运行容器时加载这个文件：

  docker run --env-file .env my-image
  

• 在Dockerfile中设置默认值（适合有默认配置的场景）：
  可以在构建镜像时预先设置环境变量，运行时用-e覆盖即可：

  FROM openjdk:17-jdk-slim
  # 设置默认值
  ENV TEST_VAR=default_test_value
  COPY target/your-app.jar app.jar
  CMD ["java", "-jar", "app.jar"]
  

Spring Boot读取环境变量的更优方式 #

除了System.getenv()，Spring Boot还提供了更贴合框架风格的读取方式：

• 使用@Value注解直接注入：

  @RestController
  public class TestController {
      // 冒号后面是默认值，当变量不存在时会用这个值
      @Value("${TEST_VAR:default_value}")
      private String testVar;
  
      @GetMapping("/get-test-var")
      public String getTestVar() {
          return "TEST_VAR的值是：" + testVar;
      }
  }
  

• 使用Environment对象读取：

  @SpringBootApplication
  public class MyApplication {
      public static void main(String[] args) {
          ApplicationContext ctx = SpringApplication.run(MyApplication.class, args);
          Environment env = ctx.getEnvironment();
          System.out.println("TEST_VAR: " + env.getProperty("TEST_VAR"));
      }
  }
  

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