Kubernetes部署中Spring Boot无法读取application.properties问题求助

问题描述 #

作为Kubernetes新手，部署Spring Boot应用时将ConfigMap挂载到容器的/config路径，但应用无法识别ConfigMap中的application.properties文件。相关配置如下：

Deployment配置 #

apiVersion: apps/v1
kind: Deployment
metadata:
  name: myapp
  namespace: default
spec:
  replicas: 2
  selector:
    matchLabels:
      app: myapp
  template:
    metadata:
      labels:
        app: myapp
    spec:
      containers:
        - name: myapp
          image: 34343434.dkr.ecr.asia-2.amazonaws.com/myapp:latest
          ports:
            - containerPort: 80
          volumeMounts:
          - name: application-properties
            mountPath: /config
      volumes:
      - name: application-properties
        configMap:
          name: application-properties

ConfigMap创建命令 #

kubectl create configmap application-properties -–from-file=/users/me/application.properties

排查与解决步骤 #

1. 确认ConfigMap内容正确性 #

首先检查ConfigMap是否正确包含application.properties的内容：

kubectl get configmap application-properties -o yaml

• 查看输出的data字段，确认存在application.properties且内容与本地文件一致
• 注意：创建命令中的-–from-file包含中文长破折号，属于输入错误，正确参数应为--from-file。若ConfigMap内容为空，重新执行正确命令：

  kubectl delete configmap application-properties
  kubectl create configmap application-properties --from-file=/users/me/application.properties
  

2. 验证容器内文件状态 #

进入Pod容器，检查挂载的文件是否存在、内容及权限是否正常：

# 获取目标Pod名称
kubectl get pods -l app=myapp
# 进入容器
kubectl exec -it <pod-name> -- /bin/bash
# 查看/config目录下的文件
ls /config
# 查看文件内容
cat /config/application.properties
# 检查文件读取权限
ls -l /config/application.properties

3. 配置Spring Boot扫描外部配置路径 #

Spring Boot默认配置扫描路径不包含绝对路径/config，需显式指定，可通过以下方式实现：

方式一：在Deployment中添加启动参数

修改容器启动命令，追加配置路径参数：

containers:
  - name: myapp
    image: 34343434.dkr.ecr.asia-2.amazonaws.com/myapp:latest
    ports:
      - containerPort: 80
    command: ["java"]
    args: ["-jar", "your-app.jar", "--spring.config.location=classpath:/,classpath:/config/,file:./,file:./config/,file:/config/"]
    volumeMounts:
    - name: application-properties
      mountPath: /config

方式二：设置环境变量

在容器中添加SPRING_CONFIG_LOCATION环境变量：

containers:
  - name: myapp
    image: 34343434.dkr.ecr.asia-2.amazonaws.com/myapp:latest
    ports:
      - containerPort: 80
    env:
      - name: SPRING_CONFIG_LOCATION
        value: "classpath:/,classpath:/config/,file:./,file:./config/,file:/config/"
    volumeMounts:
    - name: application-properties
      mountPath: /config

方式三：修改Dockerfile启动命令

在构建镜像的Dockerfile中直接配置启动参数：

ENTRYPOINT ["java", "-jar", "your-app.jar", "--spring.config.location=classpath:/,classpath:/config/,file:./,file:./config/,file:/config/"]

4. 避免挂载覆盖原有目录 #

若容器内/config目录原本存在其他配置文件，直接挂载卷会覆盖整个目录，可使用subPath仅挂载单个文件：

volumeMounts:
- name: application-properties
  mountPath: /config/application.properties
  subPath: application.properties

5. 查看应用日志定位问题 #

通过Pod日志查看Spring Boot配置加载的详细信息：

kubectl logs <pod-name>

查找是否有Loading config file from file:/config/application.properties类的加载日志，或配置加载失败的错误提示，进一步定位问题。

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