更多Spring文章，欢迎点击 ​​一灰灰Blog-Spring专题​​

前面一篇主要介绍的是如何获取配置信息，接下来则是另外一个非常非常基础和必要的知识点了，应用如何根据不同的环境来选择对应的配置，即配置的多环境选择问题

I. 多环境配置

配置区分环境，最直观的如测试环境和生产环境的DB不同，测试环境的应用要求连接测试DB；生成环境的应用要求连生成DB；对于应用本身来说，业务代码啥的都是一样，无非就是DB的配置不同，如果在代码中写死环境判断，然后进行选择配置话，就不太优雅了；

SpringBoot本身就支持多环境配置文件，应用的配置，除了 ​​application.yml​​ 文件之外，还会有环境相关的配置，如下一个实例

application.yml
application-dev.yml
application-pro.yml

1. 多环境选择

a. 命令规则

配置文件，一般要求是以 ​​application​​ 开头，可以是yml文件也可以是properties文件

b. 配置选择

如何确定哪个配置配置文件（application-dev.yml 与 application-pro.yml）生效呢？

  • 通过配置信息 ​​spring.profile.active​​ 来指定需要加载的配置文件

通常这个配置信息会放在 ​​applicatin.yml​​ 文件中，如下

spring:
  profiles:
    active: dev

上面这个表示，当前的配置信息，会从 ​​application.yml​​​ 和 ​​application-dev.yml​​​ 文件中获取；且​​-dev​​文件中定义的配置信息，会覆盖前面的配置信息

注意

  • 上面这个配置的value，可以指定多个配置文件，用英文逗号分隔
  • 其中最右边的优先级最高，覆盖左边配置文件中重名的配置信息

c. 实例演示

配置文件内容如下

application.yml

# 端口号
server:
  port: 8081

spring:
  profiles:
    active: dev,biz


biz:
  total: application

application-dev.yml

biz:
  env: dev-environment
  profile: dev-profile

application-pro.yml

biz:
  env: pro-environment
  profile: pro-profile

application-biz.yml

biz:
  whitelist: a,b,c,d,e,f,g
  ratelimit: 1,2,3
  total: application-biz
  profile: biz-profile

通过前面的规则进行分析，当前选中生效的配置文件为

  • application.yml, application-dev.yml, application-biz.yml
  • 优先级为：biz文件的配置覆盖dev文件，dev文件的覆盖​​application​​的配置

代码验证如下

package com.git.hui.boot.properties;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.core.env.Environment;

/**
 * Created by @author yihui in 09:17 18/9/20.
 */
@SpringBootApplication
public class Application {

    public Application(Environment environment) {
        String env = environment.getProperty("biz.env");

        String whitelist = environment.getProperty("biz.whitelist");
        String ratelimit = environment.getProperty("biz.ratelimit");

        String total = environment.getProperty("biz.total");
        String profile = environment.getProperty("biz.profile");

        // application.yml文件中的配置 spring.profile.active指定具体选中的配置文件，为 application-dev 和 application-biz
        // read from application-dev.yml
        System.out.println("env: " + env);

        // read from application-biz.yml
        System.out.println("whitelist: " + whitelist);
        System.out.println("ratelimit: " + ratelimit);


        // 当配置文件 application.yml, application-dev.yml, application-biz.yml 三个文件都存在时，覆盖规则为
        // biz > dev > application.yml  （其中 biz>dev的原则是根据 spring.profile.active 中定义的顺序来的，最右边的优先级最高）
        // read from application-biz.yml
        System.out.println("total: " + total);

        // read from application-biz.yml
        System.out.println("profile: " + profile);
    }

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

}

输出结果为

env: dev-environment
whitelist: a,b,c,d,e,f,g
ratelimit: 1,2,3
total: application-biz
profile: biz-profile

2. 优先级问题

上面虽然看是实现了多环境的配置问题，但看完之后有一个明显的疑问，选择环境的配置信息写死在​​application.yml​​文件中，难道说部署到测试和生产环境时，还得记得手动改这个配置的值么？

如果是这样的话，也太容易出问题了吧。。。

那么如何解决这个问题呢，常见的一种方式是通过启动脚本，传入当前环境的参数，来覆盖选中的环境

a. 配置文件优先级

默认的配置文件是放在 ​​src/main/resources​​ 目录下，当然也是可以放其他位置的

  • 外置，在相对于应用程序运行目录的 ​​/config​​ 子目录中
  • 外置，在应用程序运行的目录中
  • 内置，放在config包下(即 src/main/resources/config)目录下
  • 内置，放在classpath根目录下（即默认的 src/main/resources/目录下)

上面的优先级是从高到低来的，即外置的改与内置的；config下面的高于根目录下的

以内置的两个进行对比，实测结果如下

b. 配置信息来源

前面一篇中，遗留了一个问题，就是在配置文件中配置了属性 ​​user.name = 一灰灰blog​​​, 但是实际取出的却是 ​​user​​ (我个人的电脑用户名)，也就是说，Environment中读取的配置信息，不仅仅是从配置文件中获取，还要其他的一些配置信息来源

根据优先级对属性来源进行排序，如下

  • 根目录下的开发工具全局设置属性(当开发工具激活时为~/.spring-boot-devtools.properties)。
  • 测试中的@TestPropertySource注解。
  • 测试中的@SpringBootTest#properties注解特性。
  • 命令行参数
  • SPRING_APPLICATION_JSON中的属性(环境变量或系统属性中的内联JSON嵌入)。
  • ServletConfig初始化参数。
  • ServletContext初始化参数。
  • java:comp/env里的JNDI属性
  • JVM系统属性
  • 操作系统环境变量
  • 随机生成的带random.* 前缀的属性（在设置其他属性时，可以应用他们，比如${random.long}）
  • 应用程序以外的application.properties或者appliaction.yml文件
  • 打包在应用程序内的application.properties或者appliaction.yml文件
  • 通过@PropertySource标注的属性源
  • 默认属性(通过SpringApplication.setDefaultProperties指定).

3. 环境选择的几种方式

看了上面的配置信息来源，我们可以如何优雅的实现不同环境选择不同的配置文件呢？有下面两个容易想到和实现的方式了

  • 命令行参数
  • 应用程序外的配置文件

a. 命令行参数方式

这种实现思路就是在启动脚本中，传入当前环境，然后覆盖掉属性 ​​--spring.profiles.active​​，对业务来说，就不需要做任何的改动了，只要启动脚本本身区分环境即可，唯一的要求就是遵循统一的规范，一个简单的实现如下

假定命令行的第一个参数就是环境，取出这个参数，传入即可

public static void main(String[] args) {
      if (args.length > 0) {
          SpringApplication.run(Application.class, "--spring.profiles.active=" + args[0] + ",biz");
      } else {
          SpringApplication.run(Application.class);
      }
  }

实测结果，注意下面红框内的pro，覆盖了配置文件中的dev

说明

当然可以直接传入完整的命令行参数​​--spring.profiles.active=pro,biz​​，这样代码内部就不需要进行特殊处理

b. 外置配置文件方式

当程序以独立的jar运行时，我个人的感觉是外置的配置文件是优于内置的配置文件的；因为修改配置的话，不需要重新打包部署，直接改即可

这种实现方式也没啥好多说的，相当于把配置文件拉出来放在外面而已，再根据环境写具体的​​spring.profiles.active​​的值

II. 小结

  1. SpringBoot是支持多环境的配置，通过配置属性 ​​spring.profiles.active​​ 来指定
  2. ​​spring.profiles.active​​参数指定多个配置文件时，右边的优于左边的
  3. 应用外的配置文件优先于应用内，config目录下的优先于根目录下的
  4. 配置参数来源及优先级可以参看前文: ​​配置信息来源​​
  5. 命令行参数传入时，请注意写法形同 ​​--key=value​​

III. 其他

0. 项目

1. 一灰灰Blog

一灰灰的个人博客，记录所有学习和工作中的博文，欢迎大家前去逛逛

2. 声明

尽信书则不如，已上内容，纯属一家之言，因个人能力有限，难免有疏漏和错误之处，如发现bug或者有更好的建议，欢迎批评指正，不吝感激