如何在OpenShift上将ConfigMap文件加入内置Tomcat的Spring Boot Web应用类路径

我来帮你搞定这个问题——你遇到的核心矛盾就是ConfigMap挂载的路径不在Spring Boot应用的类路径范围内，导致启动时找不到配置文件。下面是一步步的具体方案，既能保证配置文件不打包进WAR包，又能让OpenShift部署时把配置加载到类路径里：

1. 先确保Maven打包时排除环境专属配置文件 #

首先得把环境相关的配置文件从WAR包里剔除，这样部署时才能完全依赖OpenShift上的ConfigMap。在你的Spring Boot模块的pom.xml中添加资源排除规则：

<build>
  <resources>
    <resource>
      <directory>src/main/resources</directory>
      <excludes>
        <!-- 排除所有环境后缀的配置文件，比如application-dev.properties、application-prod.properties -->
        <exclude>application-*.properties</exclude>
      </excludes>
    </resource>
  </resources>
</build>

2. 配置OpenShift Deployment挂载ConfigMap到类路径目录 #

Spring Boot可执行WAR包运行时，内置Tomcat会把BOOT-INF/classes当作核心类路径目录。我们可以把ConfigMap里的配置文件挂载到这个目录的子路径下（避免覆盖原有类文件），让应用能直接读取到。

示例Deployment YAML配置 #

修改你的Deployment（或DeploymentConfig），添加volumes和volumeMounts配置：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: your-spring-boot-app
spec:
  replicas: 1
  selector:
    matchLabels:
      app: your-spring-boot-app
  template:
    metadata:
      labels:
        app: your-spring-boot-app
    spec:
      containers:
      - name: your-spring-boot-app
        image: your-image:tag
        ports:
        - containerPort: 8080
        # 配置挂载路径
        volumeMounts:
        - name: app-config-volume
          # 挂载到类路径下的config子目录，既不覆盖原有文件，又能被Spring Boot扫描到
          mountPath: /deployments/BOOT-INF/classes/config
          readOnly: true
        # 可选：指定激活的环境Profile，让Spring Boot自动加载对应配置文件
        env:
        - name: SPRING_PROFILES_ACTIVE
          value: dev
      # 关联ConfigMap到Volume
      volumes:
      - name: app-config-volume
        configMap:
          name: your-configmap-name  # 替换成你的ConfigMap实际名称
          # 映射ConfigMap中的键到挂载后的文件名，要和你期望的配置文件名一致
          items:
          - key: application-dev.properties
            path: application-dev.properties
          - key: application-prod.properties
            path: application-prod.properties

路径说明 #

如果你的Spring Boot镜像用的是OpenShift默认的部署路径（比如Red Hat的OpenJDK/Spring Boot镜像，默认路径是/deployments），那么/deployments/BOOT-INF/classes就是应用的核心类路径目录。挂载到它的子目录config后，这个目录会被Spring Boot自动识别为类路径的一部分，配置文件就能被正常加载。

3. 验证配置是否生效 #

部署完成后，你可以进入Pod内部检查配置文件是否存在：

# 进入目标Pod
oc rsh <your-pod-name>

# 查看挂载的配置文件
ls /deployments/BOOT-INF/classes/config

同时查看应用日志，确认Spring Boot是否加载了指定的Profile：

oc logs <your-pod-name> | grep "The following profiles are active"

如果日志显示了你指定的Profile（比如dev），且没有配置文件找不到的报错，就说明配置成功了。

备选方案：通过启动参数指定额外配置位置 #

如果你不想直接挂载到类路径目录，也可以通过Spring Boot的启动参数加载外部配置。比如在Deployment的容器启动命令里添加：

command: ["java", "-jar", "/deployments/your-app.war", "--spring.config.additional-location=/config/"]

然后把ConfigMap挂载到/config目录，Spring Boot会自动扫描这个目录下的配置文件，效果和放到类路径类似。

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