Kubernetes集群新Deployment的Pod无法挂载已绑定NFS型PV/PVC问题咨询

• PVC资源隔离限制：PVC是命名空间级别的资源，若新Deployment部署在与存量PVC不同的命名空间下，无法直接跨命名空间引用PVC
• 节点依赖缺失：新Pod调度到的节点未安装NFS客户端工具（nfs-common/nfs-utils），无法完成NFS卷的挂载初始化
• NFS访问权限限制：NFS服务端的exports配置未放通新节点的IP访问权限，或NFS共享目录的UID/GID权限与新Pod的运行用户不匹配
• PV访问模式不兼容：若PV配置的访问模式为ReadWriteOncePod（K8s 1.23+支持），仅允许单个Pod挂载，存量Pod占用后新Pod无法挂载
• 配置拼写错误：Deployment的卷定义中PVC名称拼写错误，或volumeMounts与volumes的名称字段不匹配
• PV节点亲和性限制：PV配置了节点亲和性规则，仅允许特定节点挂载，新Pod调度到了不符合规则的节点

1. 首先获取Pod挂载失败的具体报错
   执行命令查看Pod事件：

   kubectl describe pod <异常Pod名称> -n <Deployment所在命名空间>
   

   根据Events字段的报错信息对应修复：
   • 若报错为persistentvolumeclaim "xxx" not found
     确认PVC与新Deployment是否在同一命名空间，PVC名称拼写是否正确，跨命名空间场景需在对应命名空间下创建新的PVC绑定同个NFS路径。
   • 若报错为mount: wrong fs type, bad option
     给所有集群节点安装NFS客户端工具：
     Debian/Ubuntu系节点执行：

     apt update && apt install -y nfs-common
     

     RHEL/CentOS系节点执行：

     yum install -y nfs-utils
     

   • 若报错为permission denied
     1. 登录NFS服务端查看/etc/exports配置，确保集群所有节点的IP都在放通列表中，且配置包含rw,sync,no_root_squash参数，修改后执行exportfs -ra生效
     2. 确认NFS共享目录的权限，可通过给Pod配置securityContext的runAsUser、fsGroup参数，与共享目录的所有者UID/GID保持一致
   • 若报错为node(s) did not match the volume node affinity
     要么调整PV的节点亲和性规则覆盖新Pod调度的节点，要么给Deployment新增nodeSelector配置，将Pod调度到符合PV亲和性要求的节点
   • 若报错为volume access mode conflict且PV访问模式为ReadWriteOncePod
     将PV的访问模式修改为ReadWriteMany即可支持多Pod同时挂载

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