如何在Spring Boot中动态添加环境变量凭证且不覆盖原有属性？

问题根源 #

Spring Boot中使用带索引的环境变量（比如APPLICATION_CREDENTIALS_0_*）时，会直接替换YAML配置中对应索引的元素，而非追加新元素。要实现动态新增且保留原有配置，需使用无索引的集合追加语法。

具体解决方案 #

1. 保留原有YAML配置不变

你的初始YAML配置无需修改，继续保持：

application:
  credentials:
    - key: "admin"
      secret: "42"
    - key: "user"
      secret: "1234"

2. 环境变量的正确写法

使用[]标识集合追加，每个新增凭证对应一对环境变量，无需指定索引：

# 新增第一个凭证
APPLICATION_CREDENTIALS[]_KEY=elvis
APPLICATION_CREDENTIALS[]_SECRET=aloha

# 可继续添加任意数量的凭证
APPLICATION_CREDENTIALS[]_KEY=guest
APPLICATION_CREDENTIALS[]_SECRET=guest123

启动应用后，Spring Boot会自动将环境变量中的凭证追加到原有YAML的credentials集合中，最终集合包含admin、user、elvis、guest四个凭证。

3. 代码绑定配置（推荐）

为了更便捷地在业务代码中使用合并后的凭证，建议创建配置类：

import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;
import java.util.List;

@Component
@ConfigurationProperties(prefix = "application")
public class AppCredentialsProperties {
    private List<Credential> credentials;

    // Getter & Setter
    public List<Credential> getCredentials() {
        return credentials;
    }

    public void setCredentials(List<Credential> credentials) {
        this.credentials = credentials;
    }

    // 内部类封装单个凭证
    public static class Credential {
        private String key;
        private String secret;

        // Getters & Setters
        public String getKey() { return key; }
        public void setKey(String key) { this.key = key; }
        public String getSecret() { return secret; }
        public void setSecret(String secret) { this.secret = secret; }
    }
}

之后在业务代码中注入AppCredentialsProperties，即可直接获取所有合并后的凭证列表。

注意事项 #

• 该[]追加语法仅支持Spring Boot 2.0及以上版本
• 若同时使用带索引和不带索引的环境变量，带索引的会先替换对应位置元素，不带索引的再追加
• 环境变量中新增凭证无需按顺序指定索引，[]会自动处理追加逻辑

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