Spring Boot 3.0.4升级后加载K8s ConfigMap启动报错

我们在k3s集群中运行Spring Boot 2.7.3版本应用，使用spring-cloud-starter-kubernetes-client-config自动从K8s ConfigMap读取application.yaml，运行正常。升级到Spring Boot 3.0.4版本后，启动时无法加载ConfigMap，日志显示创建reactiveUserDetailsService Bean时抛出username cannot be null异常，引发依赖注入失败。已尝试不使用特定ServiceAccount（2.7.3版本无需）、添加ServiceAccount，在k3s和minikube集群均复现该问题。

1. 对齐Spring Cloud与Spring Boot版本 #

Spring Boot 3.0.x需要搭配Spring Cloud 2022.0.x（Kilburn系列），请检查项目依赖配置：

• Maven（pom.xml）：

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

• Gradle（build.gradle）：

  implementation platform('org.springframework.cloud:spring-cloud-dependencies:2022.0.3')
  

2. 配置Kubernetes客户端权限与参数 #

Spring Cloud 2022.0.x对Kubernetes资源访问的权限校验更严格，需确保Pod的ServiceAccount具备ConfigMap读取权限：

1. 创建ServiceAccount与RBAC规则：

   apiVersion: v1
   kind: ServiceAccount
   metadata:
     name: app-config-sa
     namespace: default
   ---
   apiVersion: rbac.authorization.k8s.io/v1
   kind: Role
   metadata:
     name: configmap-reader
     namespace: default
   rules:
   - apiGroups: [""]
     resources: ["configmaps"]
     verbs: ["get", "list", "watch"]
   ---
   apiVersion: rbac.authorization.k8s.io/v1
   kind: RoleBinding
   metadata:
     name: app-config-binding
     namespace: default
   subjects:
   - kind: ServiceAccount
     name: app-config-sa
   roleRef:
     kind: Role
     name: configmap-reader
     apiGroup: rbac.authorization.k8s.io
   

2. 在Deployment中指定ServiceAccount：

   spec:
     serviceAccountName: app-config-sa
   

3. 确认应用配置中开启K8s ConfigMap加载：

   spring:
     cloud:
       kubernetes:
         config:
           enabled: true
           name: your-configmap-name # 替换为你的ConfigMap名称
           namespace: default
   

3. 调整配置加载顺序 #

Spring Boot 3.x的自动配置阶段有变化，需确保K8s ConfigMap配置在Spring Security Bean初始化前加载：
在你的Spring Security配置类上添加@DependsOn("kubernetesPropertySource")注解，强制等待K8s配置加载完成：

@Configuration
@DependsOn("kubernetesPropertySource")
public class SecurityConfig {
    // 你的Security配置逻辑
}

4. 排查配置项合法性 #

username cannot be null异常通常是ConfigMap中对应的用户名配置缺失或未正确绑定：

• 检查ConfigMap中是否存在用户配置项（如spring.security.user.name），且值不为空；
• 若使用自定义配置绑定，确保配置类的属性设置了合理默认值，避免绑定失败：

  @ConfigurationProperties(prefix = "app.security")
  public class SecurityProperties {
      private String username = "default-user"; // 设置默认值
      // getter/setter
  }
  

5. 开启调试日志定位问题 #

添加日志配置，查看ConfigMap加载的详细过程：

logging:
  level:
    org.springframework.cloud.kubernetes.client.config: DEBUG
    io.kubernetes.client: DEBUG

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