如何在Helm部署的Java Spring Boot应用中读取ConfigMap配置

我来帮你梳理下这个问题的解决方案，刚好我之前做过类似的K8s+Spring Boot+Helm部署场景，分几个部分给你讲清楚，保证你能快速落地：

首先要明确：Spring Boot天生支持外部配置优先级高于内置配置，所以只要我们把环境专属的配置放到它能识别的位置，或者通过参数指定，就能轻松覆盖镜像里resources目录下的默认application.properties。

这种方式直接把环境对应的application-xxx.properties挂载到Spring Boot自动扫描的路径，不需要修改代码就能生效。

具体步骤： #

1. Helm中定义ConfigMap模板
   在你的Helm Chart的templates目录下创建configmap.yaml，根据环境的values.yaml动态生成配置：

apiVersion: v1
kind: ConfigMap
metadata:
  name: {{ .Release.Name }}-app-config
  namespace: {{ .Release.Namespace }}
data:
  application-{{ .Values.env }}.properties: |-
    {{- .Files.Get .Values.configFile | nindent 4 }}

然后在环境专属的values文件里指定配置：

• values-dev.yaml：

  env: dev
  configFile: "config/application-dev.properties"
  

• values-prod.yaml：

  env: prod
  configFile: "config/application-prod.properties"
  

记得把你的application-dev.properties和application-prod.properties放到Helm Chart的config目录下。

2. 将ConfigMap挂载到容器
   在Deployment模板里添加volume和volumeMount，把配置文件挂载到Spring Boot默认扫描的/config目录：

volumes:
  - name: app-config
    configMap:
      name: {{ .Release.Name }}-app-config
containers:
  - name: {{ .Chart.Name }}
    image: "{{ .Values.image.repository }}:{{ .Values.image.tag }}"
    volumeMounts:
      - name: app-config
        mountPath: /config
        readOnly: true

Spring Boot会自动加载/config目录下的配置，优先级高于内置的resources目录文件。

3. 可选：指定激活的环境 profile
   如果你的配置文件是带环境后缀的（比如application-dev.properties），可以在Deployment的启动参数里明确激活对应profile，确保加载正确的配置：

containers:
  - name: {{ .Chart.Name }}
    image: "{{ .Values.image.repository }}:{{ .Values.image.tag }}"
    args: ["--spring.profiles.active={{ .Values.env }}"]

如果不想挂载整个文件，而是把单个配置项转成环境变量，Spring Boot也能自动识别——规则是把配置的.换成_并大写，比如spring.datasource.url对应环境变量SPRING_DATASOURCE_URL。

具体步骤： #

1. Helm中生成环境变量式的ConfigMap
   在环境专属的values文件里定义配置项：

# values-dev.yaml
appConfig:
  spring:
    datasource:
      url: jdbc:mysql://dev-db:3306/mydb
      username: dev-user
    server:
      port: 8080

然后在configmap.yaml里生成对应的环境变量键值对：

apiVersion: v1
kind: ConfigMap
metadata:
  name: {{ .Release.Name }}-app-config-env
data:
  {{- range $key, $value := .Values.appConfig }}
  {{- range $k, $v := $value }}
  {{ snakecase $key | upper }}_{{ snakecase $k | upper }}: "{{ $v }}"
  {{- end }}
  {{- end }}

（Helm默认包含sprig库，snakecase和upper函数可以直接用）

2. 注入环境变量到容器
   在Deployment里把ConfigMap的内容作为环境变量注入：

containers:
  - name: {{ .Chart.Name }}
    image: "{{ .Values.image.repository }}:{{ .Values.image.tag }}"
    envFrom:
      - configMapRef:
          name: {{ .Release.Name }}-app-config-env

Spring Boot会自动将这些环境变量映射为配置属性，优先级同样高于内置配置。

• 可以添加Spring Boot Actuator依赖，通过/env端点查看配置来源：

  <dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-actuator</artifactId>
  </dependency>
  

  然后在配置里开启端点：

  management.endpoints.web.exposure.include=env
  

  部署后访问http://<pod-ip>:8080/actuator/env，就能看到配置的加载顺序和来源，确认外部配置是否覆盖了内置文件。
• 也可以查看应用启动日志，找类似Loading config file from的日志行，确认外部配置被加载。

最后，部署不同环境时指定对应的values文件即可：

# 部署dev环境到dev命名空间
helm upgrade --install my-app ./my-chart -n dev -f values-dev.yaml

# 部署prod环境到prod命名空间
helm upgrade --install my-app ./my-chart -n prod -f values-prod.yaml

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