K8s StatefulSet部署失败求助：含PVC模板与外部PVC配置问题

报错信息 #

FailedCreate: create Pod myapp-0 in StatefulSet myapp failed error: Pod "myapp-0" is invalid: [spec.volumes[3].persistentVolumeClaim.claimName: Required value, spec.containers[1].volumeMounts[3].name: Not found: "external-pvc"]

问题分析与修复步骤 #

1. Kubernetes API字段大小写错误 #

Kubernetes API字段采用驼峰命名规则，persistentVolumeClaim下的PVC名称字段应为claimName，而非全小写的claimname。你的StatefulSet配置中，volumes里的PVC引用均写错了字段名，导致Kubernetes无法识别PVC名称，触发"Required value"错误。

2. StatefulSet自动管理的PVC无需手动声明 #

volumeClaimTemplates定义的PVC会由StatefulSet自动为每个Pod创建并挂载，不需要在spec.template.spec.volumes中手动添加这些PVC的条目，否则会导致重复定义冲突。

3. 容器配置格式错误 #

你的containers数组缺少元素标识-，导致Kubernetes解析容器配置异常，出现了不存在的第二个容器（索引1），进而引发volumeMounts找不到的错误。

修复后的StatefulSet配置 #

apiVersion: apps/v1
kind: StatefulSet
metadata:
  labels:
    app.kubernetes.io/instance: myapp
    app.kubernetes.io/managed-by: Helm
    app.kubernetes.io/name: myapp
    app.kubernetes.io/version: 1.16.0
    argocd.argoproj.io/instance: myapp
    helm.sh/chart: myapp-0.1.6
  name: myapp
  namespace: mynamespace
spec:
  replicas: 1
  selector:
    matchLabels:
      app.kubernetes.io/instance: myapp
      app.kubernetes.io/name: myapp
  template:
    metadata:
      labels:
        app.kubernetes.io/instance: myapp
        app.kubernetes.io/name: myapp
    spec:
      containers:
      - image: 'lscr.io/linuxserver/myapp:latest'
        imagePullPolicy: IfNotPresent
        name: myapp
        securityContext: {}
        volumeMounts:
          - mountPath: /config
            name: myapp-config
          - mountPath: /mount01
            name: myapp-01
          - mountPath: /mount02
            name: myapp-02
          - mountPath: /mount03
            name: external-pvc
      securityContext: {}
      volumes:
      - name: external-pvc
        persistentVolumeClaim:
          claimName: external-pvc  # 修正为驼峰命名
  volumeClaimTemplates:
    - metadata:
        name: myapp-config
      spec:
        accessModes:
          - ReadWriteOnce
        resources:
          requests:
            storage: 1Gi
        storageClassName: nfs-csi-applications
        volumeName: pv-myapp-config
    - metadata:
        name: myapp-01
      spec:
        accessModes:
          - ReadWriteMany
        resources:
          requests:
            storage: 1Ti
        storageClassName: nfs-csi-applications
        volumeName: pv-myapp-01
    - metadata:
        name: myapp-02
      spec:
        accessModes:
          - ReadWriteMany
        resources:
          requests:
            storage: 15Ti
        storageClassName: nfs-csi-applications
        volumeName: myapp-02

验证要点 #

• 确认外部PVC external-pvc 已在mynamespace命名空间中处于Bound状态
• 应用修复后的配置后，检查StatefulSet的Pod是否正常创建，验证所有挂载路径是否可访问

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