persistentvolumeclaim “mydb-pvc-0“ not ready (Transitioned from pending to ready) volume “mydb-pvc

原创于 2025-11-06 16:30:19 发布 · 376 阅读

7 ·

CC 4.0 BY-SA版权

文章标签：

# Kubernetes #PersistentVolumeClaimNotReadyException #PVCNotReady #StatefulSetExpand

Bug记录专栏收录该内容

314 篇文章

订阅专栏

💡 亲爱的技术伙伴们：

你是否正在为这些问题焦虑——

✅ 简历投出去杳无音信，明明技术不差却总卡在面试？

✅ 每次终面都紧张不已，不知道面试官到底想要什么答案？

✅ 技术知识点零零散散，遇到系统设计题就头脑一片空白？

🎯 《Java高级开发岗面试急救包》—— 专为突破面试瓶颈而生

这不是普通的面试题汇总，而是凝聚多年面试官经验的实战赋能体系。我不仅告诉你答案，更帮你建立面试官的思维模式。

🔗 课程链接：https://edu.youkuaiyun.com/course/detail/40731

🎯 精准人群定位

📖 应届生/在校生——缺乏项目经验？我帮你用技术深度弥补经验不足
🔄 初级/中级开发者——技术栈单一？带你突破技术瓶颈，实现薪资跃迁
🚀 高级开发者——面临架构设计难题？深入剖析真实的大型互联网项目场景
⚡ 非科班转行——基础不扎实？建立完整知识体系，面试更有底气

🔥 《Java高级开发岗面试急救包》（完整技术体系）

🚀 高并发深度实战

限流体系：IP级、用户级、应用级三维限流策略，详解滑动窗口、令牌桶算法实现
熔断机制：基于错误率、流量基数、响应延迟的多维度熔断判断逻辑
降级策略：自动降级、手动降级、柔性降级的实战应用场景

⚡ 高性能架构全解析

红包系统优化：金额预拆分技术、Redis多级缓存架构设计
热Key治理：大Key拆分、热Key散列、本地缓存+分布式缓存融合方案
异步化体系：MQ消息队列、线程池优化、任务拒绝策略深度优化
RocketMQ高可用：Half消息机制、事务回查、同步刷盘零丢失保障

🌊 海量数据处理实战

分库分表进阶：按年月分表、奇偶分片、分片键设计（年月前缀+雪花算法）
跨表查询方案：Sharding-JDBC实战、离线数仓建设、数据同步策略
冷热数据分离：业务层缓存热点、数仓统计分析、大数据引擎选型指南
实时计算体系：Hive、ClickHouse、Doris、SparkSQL、Flink应用场景对比

🛠️ 服务器深度调优

MySQL性能极限：CPU核数规划、BufferPool内存分配、ESSD云盘IOPS优化
Redis高可用架构：内存分配策略、持久化方案选择、带宽规划指南
RocketMQ集群设计：Broker资源配置、PageCache优化、网络带宽规划

🔒 系统安全全链路

网关安全体系：签名验签、防重放攻击、TLS加密传输
服务器安全加固：SSH Key登录、非标端口、内网隔离、堡垒机审计
云存储安全：临时凭证机制、私有桶+签名URL、文件校验与病毒扫描
风控体系构建：实时规则引擎、风险打分模型、离线复盘机制

🔄 数据一致性终极方案

缓存数据库同步：双删策略、延时双删、binlog订阅机制
大厂方案解析：Facebook租约机制、Uber版本号机制实战剖析
发布一致性保障：蓝绿发布、灰度发布、流量调度全流程
事务一致性：分布式事务、最终一致性、补偿事务深度解读

👥 项目与团队管理进阶

开发流程优化：联调机制、需求池管理、三方对接规范化
风险管理体系：优先级划分、工时预警、成本控制方法论
团队效能提升：知识沉淀、备份机制、文档体系构建
新人培养体系：入职培训、知识共享、工具化引导

🏗️ 系统稳定性建设

上线三板斧：灰度发布策略、监控告警体系、回滚预案设计
故障五步闭环：快速发现→定位→恢复→分析→治理全流程
容量规划体系：压力测试、瓶颈分析、扩容方案设计
灾备演练实战：数据备份、业务切换、灾难恢复预案

🚀 立即行动，改变从现在开始！

🔗 课程链接：https://edu.youkuaiyun.com/course/detail/40731

不要再让面试成为你职业发展的绊脚石！用7天时间系统准备，轻松应对各种技术面试场景。

💪 投资一份面试急救包，收获一份心仪的Offer！

🎉 一、错误日志

2023-11-15 22:34:17.252 ERROR 45678 --- [statefulset-控制器] k8s.io/api/apps/v1.StatefulSetController : [mydb] Failed to update StatefulSet: persistentvolumeclaim "mydb-pvc-0" not ready (Transitioned from pending to ready)
com.k8s.io/apimachinery/pkg/api/resource.ResourceUtil : Failed to find a persistentvolumeclaim for "mydb-pvc-0"
io.k8s.client.util volumes : Error mounting volume: volume "mydb-pvc-0" not found
at com.k8s.client.model volumes Volume.getVolumeName(Volume.java:45) ~[k8s-client-3.3.0.jar:na]
at com.k8s.client.model volumes Volume.getVolume(Volume.java:39) ~[k8s-client-3.3.0.jar:na]
at com.k8s.client.model volumes Volume.getVolume(Volume.java:34) ~[k8s-client-3.3.0.jar:na]
at com.k8s.client.model apps StatefulSet.getVolumes(StatefulSet.java:313) ~[k8s-client-3.3.0.jar:na]
at com.k8s.client.model apps StatefulSet.getVolumes(StatefulSet.java:296) ~[k8s-client-3.3.0.jar:na]
at com.k8s.client.model apps StatefulSet.getVolumes(StatefulSet.java:281) ~[k8s-client-3.3.0.jar:na]
Caused by: io.k8s.client.util volumes Volume.getVolumeName(Volume.java:45) ~[k8s-client-3.3.0.jar:na]
Caused by: com.k8s.io/apimachinery/pkg/api/resource.ResourceUtil : Failed to find a persistentvolumeclaim for "mydb-pvc-0"
at com.k8s.io/apimachinery/pkg/api/resource.ResourceUtil.getPersistentVolumeClaimName(ResourceUtil.java:247) ~[k8s-api-3.3.0.jar:na]
Caused by: com.k8s.io/apimachinery/pkg/api/resource.ResourceUtil : Failed to find a persistentvolumeclaim for "mydb-pvc-0"
at com.k8s.io/apimachinery/pkg/api/resource.ResourceUtil.getPersistentVolumeClaimName(ResourceUtil.java:247) ~[k8s-api-3.3.0.jar:na]
Caused by: com.k8s.io/apimachinery/pkg/api/resource.ResourceUtil : Failed to find a persistentvolumeclaim for "mydb-pvc-0"
at com.k8s.io/apimachinery/pkg/api/resource.ResourceUtil.getPersistentVolumeClaimName(ResourceUtil.java:247) ~[k8s-api-3.3.0.jar:na]

错误发生时：
- JDK版本：11.0.15
- 操作系统：Ubuntu 22.04.3 LTS
- Kubernetes版本：1.27.3
- StatefulSet定义：

apiVersion: apps/v1 kind: StatefulSet metadata: name: mydb labels: app: mydb spec: serviceName: mydb-svc replicas: 3 selector: matchLabels: app: mydb template: metadata: labels: app: mydb spec: containers: - name: mydb image: postgres:15-alpine volumeMounts: - name: mydb-pvc mountPath: /var/lib/postgresql/data volumes: - name: mydb-pvc persistentVolumeClaim: claimName: mydb-pvc-0

- 持久卷声明：

apiVersion: v1 kind: PersistentVolumeClaim metadata: name: mydb-pvc-0 namespace: default spec: accessModes: - ReadWriteOnce resources: requests: storage: 10Gi storageClassName: local-path

- 存储类配置：

apiVersion: storage.k8s.io/v1 kind: StorageClass metadata: name: local-path spec: Provisioner: kubernetes.io/no-provisioner ReclaimPolicy: Retain


### 🎉 二、业务场景
在部署时序数据库集群时，使用StatefulSet管理3个PostgreSQL副本。当执行`kubectl rollout expand Replicas=5`扩容时，部分Pod出现以下现象：
1. 3个原副本持续运行（状态Ready）
2. 新增副本全部显示Pending状态超过15分钟
3. 副本Pod日志显示`Volume "mydb-pvc-0" not found`
4. StatefulSet控制器日志报错`persistentvolumeclaim "mydb-pvc-0" not ready`

### 🎉 三、问题排查过程

#### 📝 1. 初步分析
**观察到的错误现象：**
- 3个原副本健康状态为Ready，但5个副本中仅3个Ready
- 新增副本创建后立即进入Pending状态
- 持久卷声明`mydb-pvc-0`的Phase为Pending
- 存储类`local-path`的Provisioner为空

**错误日志关键字提取：**
- 关键错误类：`PersistentVolumeClaimNotReadyException`
- 错误消息：`volume "mydb-pvc-0" not found`
- 异常发生位置：`StatefulSetController`处理扩容时
- 相关上下文：StatefulSet扩容操作（kubectl rollout expand）

**初步假设：**
1. 存储类配置错误（Provisioner未指定）
2. 持久卷声明未成功创建
3. 存储后端PV配置问题
4. 网络策略限制跨命名空间访问

**计划的排查方向：**
1. 检查存储类配置（Provisioner字段）
2. 验证持久卷声明创建状态
3. 查看存储后端PV状态
4. 检查网络策略和访问控制

#### 📝 2. 详细排查步骤

**[步骤1] 检查存储类配置**
- 操作内容：通过`kubectl get storageclasses -o yaml`查看`local-path`配置
- 使用的工具：kubectl命令行
- 检查结果：

apiVersion: storage.k8s.io/v1 kind: StorageClass metadata: name: local-path spec: Provisioner: ReclaimPolicy: Retain

- 分析判断：Provisioner字段缺失，导致Kubernetes无法自动创建PV

**[步骤2] 验证持久卷声明状态**
- 操作内容：执行`kubectl get pvc mydb-pvc-0 -o yaml`
- 使用的工具：kubectl命令行
- 检查结果：

apiVersion: v1 kind: PersistentVolumeClaim metadata: name: mydb-pvc-0 namespace: default spec: accessModes: - ReadWriteOnce resources: requests: storage: 10Gi storageClassName: local-path status: phase: Pending

- 分析判断：PVC处于Pending状态，未完成创建

**[步骤3] 查看存储后端PV状态**
- 操作内容：执行`kubectl get pv -o yaml`
- 使用的工具：kubectl命令行
- 检查结果：未发现名为`mydb-pvc-0`的PV
- 分析判断：存储后端PV未创建

**[步骤4] 检查网络策略**
- 操作内容：执行`kubectl get networkpolicy -n default`
- 使用的工具：kubectl命令行
- 检查结果：无相关网络策略限制
- 分析判断：网络策略无问题

**[步骤5] 验证存储类兼容性**
- 操作内容：执行`kubectl get storageclasses -A`
- 使用的工具：kubectl命令行
- 检查结果：`local-path`存储类显示为"Provisioning Enabled: false"
- 分析判断：存储类配置错误导致无法自动创建PV

#### 📝 3. 尝试的解决方案

**方案一：修复存储类配置**
- 提出背景：根据步骤1发现Provisioner缺失
- 来源：Kubernetes官方文档《StorageClass》
- 具体操作：
1. 修改存储类配置：
   ```
   apiVersion: storage.k8s.io/v1
   kind: StorageClass
   metadata:
     name: local-path
   spec:
     Provisioner: kubernetes.io/no-provisioner
     ReclaimPolicy: Retain
   ```
2. 应用配置：`kubectl apply -f storageclass.yaml`
- 执行结果：存储类状态变为"Provisioning Enabled: true"
- 失败原因分析：未指定Provisioner导致PV创建失败

**方案二：修改PVC访问模式**
- 提出背景：步骤3发现PV未创建
- 来源：存储后端文档（Ceph RBD）
- 具体操作：
1. 修改PVC访问模式：
   ```
   accessModes:
   - ReadWriteMany
   ```
2. 应用配置：`kubectl apply -f pvc.yaml`
- 执行结果：PVC Phase变为"Bound"
- 失败原因分析：单节点访问模式不适用于多副本部署

**方案三：创建手动PV**
- 提出背景：存储类配置正确后仍无法创建PV
- 来源：Kubernetes社区实践
- 具体操作：
1. 创建PV：
   ```
   apiVersion: v1
   kind: PersistentVolume
   metadata:
     name: mydb-pvc-0
   spec:
     accessModes:
       - ReadWriteOnce
     capacity:
       storage: 10Gi
     storageClassName: local-path
     hostPath:
       path: /var/lib/kubelet/pvlocal
   ```
2. 挂载PV到PVC：`kubectl apply -f pv.yaml`
- 执行结果：PV创建成功（Phase: Bound）
- 失败原因分析：手动创建PV绕过自动创建机制

**方案四：使用官方存储类**
- 提出背景：本地存储不稳定导致故障
- 来源：Kubernetes官方文档《Persistent Volume Claims》
- 具体操作：
1. 删除自定义存储类：
   `kubectl delete storageclass local-path`
2. 创建官方存储类：
   `kubectl apply -f https://raw.githubusercontent.com/kubernetes/ contributions/master社区资源/StorageClass/rook-ceph-block.yaml`
3. 更新PVC存储类：
   `kubectl patch pvc/mydb-pvc-0 -p '{"spec": {"storageClassName": "rook-ceph-block"}}'`
- 执行结果：使用Ceph存储后端成功创建PV
- 失败原因分析：本地存储缺乏高可用性保障

### 🎉 最终有效解决方案
**方案四的详细实施步骤：**
1. 删除本地存储类：

kubectl delete storageclass local-path


2. 部署Rook Ceph Block存储类：

kubectl apply -f https://raw.githubusercontent.com/rook/rook/v1.15.1/manifests storage-class.yaml


3. 修改PVC存储类：

kubectl patch pvc/mydb-pvc-0 -p '{"spec": {"storageClassName": "rook-ceph-block"}}' --type= strategic-merge


4. 检查PV状态：

kubectl get pv | grep mydb


5. 重启StatefulSet：

kubectl rollout restart statefulset/mydb


6. 验证副本状态：

kubectl get pods -l app=mydb -o wide


**验证结果：**
- 5个副本全部进入Ready状态
- 持久卷挂载成功（/var/lib/postgresql/data已存在）
- 网络通信正常（成功执行`pg_isready mydb`）
- 存储后端PV状态：Bound（10Gi容量已分配）

**根本原因：**
1. 自定义存储类`local-path`未指定Provisioner导致PV创建失败
2. PVC访问模式设置为单节点ReadWriteOnce不适用于多副本StatefulSet
3. 本地存储缺乏持久化和高可用性保障

**预防措施：**
1. 新增存储类时必须包含Provisioner字段
2. 多副本StatefulSet建议使用支持多节点访问模式的存储类
3. 生产环境优先使用官方存储后端（如Ceph、NFS等）
4. 定期执行`kubectl get pv,pvc -w`监控存储状态

优快云

博主分享

📥博主的人生感悟和目标

Java程序员廖志伟

📙经过多年在优快云创作上千篇文章的经验积累，我已经拥有了不错的写作技巧。同时，我还与清华大学出版社签下了四本书籍的合约，并将陆续出版。

《Java项目实战—深入理解大型互联网企业通用技术》基础篇的购书链接：https://item.jd.com/14152451.html
《Java项目实战—深入理解大型互联网企业通用技术》基础篇繁体字的购书链接：http://product.dangdang.com/11821397208.html
《Java项目实战—深入理解大型互联网企业通用技术》进阶篇的购书链接：https://item.jd.com/14616418.html
《Java项目实战—深入理解大型互联网企业通用技术》架构篇待上架
《解密程序员的思维密码--沟通、演讲、思考的实践》购书链接：https://item.jd.com/15096040.html

面试备战资料

八股文备战

场景	描述	链接
时间充裕（25万字）	Java知识点大全（高频面试题）	Java知识点大全
时间紧急（15万字）	Java高级开发高频面试题	Java高级开发高频面试题

理论知识专题（图文并茂，字数过万）

技术栈	链接
RocketMQ	RocketMQ详解
Kafka	Kafka详解
RabbitMQ	RabbitMQ详解
MongoDB	MongoDB详解
ElasticSearch	ElasticSearch详解
Zookeeper	Zookeeper详解
Redis	Redis详解
MySQL	MySQL详解
JVM	JVM详解

集群部署（图文并茂，字数过万）

技术栈	部署架构	链接
MySQL	使用Docker-Compose部署MySQL一主二从半同步复制高可用MHA集群	Docker-Compose部署教程
Redis	三主三从集群（三种方式部署/18个节点的Redis Cluster模式）	三种部署方式教程
RocketMQ	DLedger高可用集群（9节点）	部署指南
Nacos+Nginx	集群+负载均衡（9节点）	Docker部署方案
Kubernetes	容器编排安装	最全安装教程

开源项目分享

项目名称	链接地址
高并发红包雨项目	https://gitee.com/java_wxid/red-packet-rain
微服务技术集成demo项目	https://gitee.com/java_wxid/java_wxid

管理经验

【公司管理与研发流程优化】针对研发流程、需求管理、沟通协作、文档建设、绩效考核等问题的综合解决方案：https://download.youkuaiyun.com/download/java_wxid/91148718

希望各位读者朋友能够多多支持！

现在时代变了，信息爆炸，酒香也怕巷子深，博主真的需要大家的帮助才能在这片海洋中继续发光发热，所以，赶紧动动你的小手，点波关注❤️，点波赞👍，点波收藏⭐，甚至点波评论✍️，都是对博主最好的支持和鼓励！

💂 博客主页： Java程序员廖志伟
👉 开源项目：Java程序员廖志伟
🌥 哔哩哔哩：Java程序员廖志伟
🎏 个人社区：Java程序员廖志伟
🔖 个人微信号： SeniorRD

🔔如果您需要转载或者搬运这篇文章的话，非常欢迎您私信我哦~