Kubernetes创建MongoDB StatefulSet时触发spec字段更新禁止错误

报错根因 #

你遇到的报错是Kubernetes StatefulSet的默认规则限制：StatefulSet创建完成后，仅支持修改replicas、template、updateStrategy三类字段，其余字段（如serviceName、selector、卷声明规则等）均为不可变字段。如果修改了这些字段后对已存在的StatefulSet执行更新操作（比如重复执行kubectl apply），就会触发该报错。

解决方法 #

测试环境（可接受短时间中断） #

直接删除原有StatefulSet后重新提交配置即可：

# 删除现有StatefulSet
kubectl delete statefulset -n development mongo-development
# 重新应用所有配置
kubectl apply -f service.yaml -f pvc.yaml -f statefulset.yaml

如果不想删除正在运行的MongoDB Pod，可以添加--cascade=orphan参数，删除StatefulSet后保留运行中的Pod，新StatefulSet创建后会自动接管现有Pod。

生产环境（不可中断） #

如果必须调整不可变字段，需要先完成MongoDB数据备份，再用新配置重建StatefulSet；如果仅需调整容器镜像、环境变量等属于template字段下的配置，直接提交更新即可，不会触发报错。

配置潜在优化点 #

你当前的StatefulSet直接绑定了固定PVC，仅适合单副本场景。如果后续有扩容多副本的需求，建议将PVC定义移到StatefulSet的volumeClaimTemplates字段下，让K8s自动为每个副本生成独立的PVC，避免多副本共用一个PVC导致的数据冲突：

# statefulset.yaml 调整示例，删除原有 template.spec.volumes 字段，新增如下配置
apiVersion: apps/v1
kind: StatefulSet
metadata:
  name: mongo-development
  namespace: development
spec:
  selector:
    matchLabels:
      app: mongo-development
  serviceName: mongo-development
  replicas: 1
  # 新增volumeClaimTemplates配置
  volumeClaimTemplates:
  - metadata:
      name: mongodb-persistent-storage
      labels:
        app: mongo-development
    spec:
      accessModes:
      - ReadWriteOnce
      resources:
        requests:
          storage: 5Gi
      storageClassName: gp2
  template:
    metadata:
      labels:
        app: mongo-development
    spec:
      containers:
      - name: mongo-development
        image: mongo
        imagePullPolicy: Always
        env:
        - name: MONGO_INITDB_ROOT_USERNAME
          value: "xxxx"
        - name: MONGO_INITDB_ROOT_PASSWORD
          value: "xxxx"
        ports:
        - containerPort: 27017
          name: mongodb
        volumeMounts: 
        - name: mongodb-persistent-storage
          mountPath: /var/lib/mongodb

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