Helm覆盖配置未生效：SpringBoot应用未加载环境特定配置

一、确认SpringBoot环境是否正确激活stage #

• 检查helm-override.yaml里有没有设置SPRING_PROFILES_ACTIVE环境变量，正确配置示例：

  env:
    - name: SPRING_PROFILES_ACTIVE
      value: "stage"
  

• 登录GCP的K8s集群，执行命令验证Pod的环境变量：

  kubectl exec <你的Pod名称> -- printenv | grep SPRING_PROFILES_ACTIVE
  

  确保输出为stage，若不是则环境未激活，配置文件不会被加载。

二、验证Helm的配置挂载是否正确 #

• 检查helm-override.yaml中的ConfigMap挂载配置，需确保application-stage.properties挂载到SpringBoot可识别的路径（通常是/config或镜像内BOOT-INF/classes同级的config目录），示例配置：

  volumes:
    - name: stage-config-volume
      configMap:
        name: stage-app-config
  volumeMounts:
    - name: stage-config-volume
      mountPath: /app/config
      readOnly: true
  

• 检查ConfigMap内容是否正确：

  kubectl get configmap stage-app-config -o yaml
  

  确认data字段包含正确的application-stage.properties键值对。
• 进入Pod内部检查挂载的文件：

  kubectl exec <你的Pod名称> -- cat /app/config/application-stage.properties
  

  确保文件存在且内容符合预期。

三、排查Docker镜像的构建问题 #

• 查看build.gradle的bootJar配置，确保未排除application-stage.properties，正确打包配置示例：

  bootJar {
      from('src/main/resources') {
          include 'application*.properties'
      }
  }
  

• 本地拉取部署用的镜像，启动验证配置是否生效：

  docker run -e SPRING_PROFILES_ACTIVE=stage <镜像名>:<版本标签>
  

  确认本地启动后能加载stage配置。
• 检查镜像内是否包含该配置文件：

  docker run --rm <镜像名>:<版本标签> cat /app/BOOT-INF/classes/application-stage.properties
  

  若输出为空或文件不存在，说明构建镜像时未打包该文件。

四、确认SpringBoot配置加载优先级 #

• SpringBoot配置存在加载顺序，高优先级配置会覆盖低优先级的，顺序为：命令行参数 > 环境变量 > 挂载的外部配置文件 > Jar包内的配置文件
• 查看Pod启动日志，搜索以下关键词：
  • The following profiles are active: 确认激活的是stage
  • Loaded config file 查看加载的配置文件路径，确认application-stage.properties在加载列表中

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