Spring Boot集成Spring Cloud Kubernetes读取ConfigMap失败求助

1. Pod ServiceAccount配置格式错误 #

你提供的Pod ServiceAccount配置存在缩进语法错误，正确的配置应该在Pod的spec字段下直接指定serviceAccountName：

spec:
  serviceAccountName: default

错误的缩进会导致Pod无法正确关联default ServiceAccount，进而缺失访问K8s API Server的权限基础。

2. Spring Cloud版本缺失导致兼容性问题 #

Spring Boot 3.1.0对应的Spring Cloud版本为2022.0.x（Kilburn分支），你未指定spring-cloud-starter-kubernetes-client-config的版本，Maven会拉取不兼容的旧版本，这很可能引发API访问异常。需在pom.xml中添加Spring Cloud依赖管理：

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-dependencies</artifactId>
            <version>2022.0.4</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

3. 无法获取Pod名称的问题 #

日志中Failed to get pod with name:[]说明应用无法读取自身Pod的名称，Spring Cloud Kubernetes默认通过以下两种方式获取Pod信息：

• 环境变量POD_NAME和POD_NAMESPACE
• K8s Downward API自动注入的字段

你需要确保Pod配置中注入这些信息，或者显式配置：

spec:
  containers:
  - name: sample-app
    env:
    - name: POD_NAME
      valueFrom:
        fieldRef:
          fieldPath: metadata.name
    - name: POD_NAMESPACE
      valueFrom:
        fieldRef:
          fieldPath: metadata.namespace

也可以在app.properties中手动指定：

spring.cloud.kubernetes.client.pod-name=${POD_NAME}
spring.cloud.kubernetes.client.namespace=${POD_NAMESPACE}

4. Role与RoleBinding的命名空间一致性检查 #

Role是命名空间级资源，你必须确认configmap-reader Role是在app-nonprod命名空间下创建的。如果Role在其他命名空间，configmap-default-binding RoleBinding无法关联到该Role，直接导致权限失效。

可通过以下命令验证：

kubectl get roles configmap-reader -n app-nonprod

若返回NotFound，说明Role创建在错误的命名空间，需重新创建到app-nonprod下。

5. 网络访问API Server的问题 #

连接超时错误说明Pod无法访问K8s API Server，需排查：

• 检查Pod是否能解析API Server域名：在Pod内执行nslookup kubernetes.default.svc
• 检查是否有NetworkPolicy阻止访问：查看app-nonprod命名空间下的NetworkPolicy规则
• 验证API Server端口连通性：在Pod内执行curl -k https://kubernetes.default.svc:443

6. ConfigMap配置的小问题 #

你的ConfigMap中使用了Helm模板{{ .Values.app.environment }}，如果不是通过Helm部署，需替换为实际的环境值（如dev/test），否则应用无法正确加载对应profile的配置。

1. 修正Pod的serviceAccountName配置格式，确保关联到default ServiceAccount
2. 添加Spring Cloud依赖管理，匹配Spring Boot 3.1.0的版本
3. 注入Pod名称和命名空间的环境变量
4. 确认Role、RoleBinding、ServiceAccount在同一个app-nonprod命名空间
5. 验证Pod到API Server的网络连通性

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