Kubernetes StatefulSet多副本无法挂载共享卷问题求助

核心错误原因 #

• 存储卷访问模式不匹配：你的PVC设置了accessModes: *ReadWriteOnce（RWO）*，这个模式定义了卷只能被单个节点挂载。当第二个StatefulSet副本调度到不同节点时，必然无法挂载已被第一个节点占用的卷；即使两个副本在同一节点，多数存储后端也不支持多个Pod同时挂载RWO模式的卷，这直接导致了你看到的MountVolume.WaitForAttach failed错误。
• StatefulSet卷使用方式误解：StatefulSet的设计初衷是为每个副本分配独立的持久卷（通过volumeClaimTemplates自动生成专属PVC/PV），你现在让两个副本共享同一个PVC，这不是StatefulSet的典型用法，且这种共享场景必须依赖支持多Pod挂载的存储模式。

针对性解决办法 #

场景1：需要两个SFTP副本共享同一存储卷 #

1. 修改PVC的访问模式为ReadWriteMany（RWX）：
   编辑你的PVC配置，将accessModes改为：

   spec:
     accessModes:
       - ReadWriteMany
   

   注意：必须确保你的存储类files支持RWX模式（比如NFS、CephFS、Azure Files等分布式存储），否则修改后PVC会处于Pending状态，因为后端无法提供符合RWX模式的PV。

场景2：不需要共享卷，每个副本用独立存储 #

1. 改用StatefulSet的volumeClaimTemplates：
   删除Pod模板中的volumes配置，在StatefulSet的spec下添加volumeClaimTemplates，让Kubernetes自动为每个副本创建专属PVC和PV：

   kind: StatefulSet
   apiVersion: apps/v1
   metadata:
     name: sftp
     labels:
       app: sftp
   spec:
     replicas: 2
     selector:
       matchLabels:
         app: sftp
     # 添加volumeClaimTemplates
     volumeClaimTemplates:
     - metadata:
         name: sftp-storage
       spec:
         accessModes: [ "ReadWriteOnce" ]
         resources:
           requests:
             storage: 10Gi
         storageClassName: files
         volumeMode: Filesystem
     template:
       metadata:
         labels:
           app: sftp
       spec:
         # 移除原有的volumes配置
         containers:
           - name: sftp
             image: atmoz/sftp
             ports:
               - containerPort: 22
                 protocol: TCP
             envFrom:
               - secretRef:
                   name: secret
             env:
               - name: SFTP_USERS
                 value: >-
                   $(SFTP_USERNAME):$SFTP_PASSWORD)::$(SFTP_GID):$(SFTP_ROOT_DIRECTORY)
             resources:
               limits:
                 cpu: 500m
                 memory: 128Mi
               requests:
                 cpu: 250m
                 memory: 64Mi
             volumeMounts:
               - name: sftp-storage
                 mountPath: /home/user1
             imagePullPolicy: IfNotPresent
         securityContext:
           fsGroup: 10001
   

   这样每个SFTP副本都会拥有自己独立的10Gi存储卷，互不干扰，符合StatefulSet的设计场景。

补充说明 #

• Deployment（无状态）和StatefulSet（有状态）在共享PVC时，都受存储卷访问模式的限制，不存在StatefulSet天然支持多副本共享卷的特性。
• *ReadWriteOnce（RWO）*适合单Pod/单节点使用的场景，*ReadWriteMany（RWX）*适合多Pod跨节点共享的场景，*ReadOnlyMany（ROX）*适合多Pod只读共享的场景。

内容的提问来源于stack exchange，提问作者f.bele