如何在Kubernetes ConfigMap中定义数组覆盖Spring Boot配置

失效原因 #

你的配置不生效主要有两个核心问题：

• K8s不允许环境变量名称包含.，你用envFrom引入带.的ConfigMap键时，K8s会自动将.替换为_，导致Spring Boot无法匹配到对应的配置项。
• Spring Boot默认对集合/数组类型的配置采用合并策略，外部注入的数组元素会追加到原有配置的数组后面，而非直接覆盖整个数组，所以本地配置的localhost条目依然存在。

解决方案 #

方案一：挂载完整配置文件（优先推荐） #

这种方式不需要处理宽松绑定规则，语法和原生application.yaml完全一致，不会出现合并问题，稳定性最高。

1. 调整ConfigMap，直接把完整的配置块作为application.yaml的值：

apiVersion: v1
kind: ConfigMap
metadata:
  name: my-configmap
data:
  application.yaml: |
    app:
      config:
        paths:
          - id: a
            uri: http://a-service
            args:
              - x=1
              - y=2
          - id: b
            uri: http://b-service
            args:
              - x=3
              - y=4

2. 调整Deployment，将ConfigMap挂载到Spring Boot默认读取的配置目录/config下，优先级高于jar包内的配置，可直接覆盖原有配置：

spec:
  containers:
  - name: your-spring-boot-app
    image: your-app-image
    volumeMounts:
    - name: config-volume
      mountPath: /config
  volumes:
  - name: config-volume
    configMap:
      name: my-configmap

方案二：环境变量注入（适用于必须用envFrom的场景） #

如果你必须通过环境变量的方式注入配置，需要做两处调整：

1. 先在应用的原生application.yaml中关闭集合合并策略，让外部配置直接覆盖本地集合：

spring:
  config:
    merge:
      enabled: false
    override-system-properties: true

2. 调整ConfigMap的键名，符合POSIX环境变量命名规则（仅允许字母、数字、下划线，开头不能为数字），Spring Boot的宽松绑定可以自动匹配下划线分隔的配置名：

apiVersion: v1
kind: ConfigMap
metadata:
  name: my-configmap
data:
  APP_CONFIG_PATHS_0_ID: a
  APP_CONFIG_PATHS_0_URI: "http://a-service"
  APP_CONFIG_PATHS_0_ARGS_0: "x=1"
  APP_CONFIG_PATHS_0_ARGS_1: "y=2"
  APP_CONFIG_PATHS_1_ID: b
  APP_CONFIG_PATHS_1_URI: "http://b-service"
  APP_CONFIG_PATHS_1_ARGS_0: "x=3"
  APP_CONFIG_PATHS_1_ARGS_1: "y=4"

3. Deployment中保留原有envFrom配置即可生效。

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