minikube部署MySQL时Pod长期处于ContainerCreating状态故障求助

排查步骤与问题解决方法 #

第一步：优先获取Pod具体错误信息 #

执行以下命令查看Pod的事件日志，定位具体报错原因：

kubectl describe pod <替换为你的mysql Pod名称>

重点查看输出末尾的Events字段内容，根据报错信息对应处理以下常见问题：

常见问题与解决方法 #

• YAML语法错误
  你提供的YAML配置中出现了HTML转义字符"，实际部署使用的YAML文件需要将其替换为正常双引号"，也可以直接去掉引号，转义字符会导致挂载路径解析失败，是该问题的高发原因。修正后的volumeMounts配置示例：

volumeMounts:
  - mountPath: "/var/lib/mysql"
    subPath: "mysql"
    name: mysql-data

• Secret不存在
  配置中引用了名为mysql-root-password的Secret用于注入数据库密码，需要先确认当前命名空间下该Secret已存在且配置正确，检查命令：

kubectl get secret mysql-root-password

如果不存在，执行以下命令创建：

kubectl create secret generic mysql-root-password --from-literal=ROOT_PASSWORD=<替换为你要设置的数据库root密码>

• PVC未正常绑定
  配置中使用了名为mysql-data-disk的PersistentVolumeClaim，需要确认该PVC状态为Bound，检查命令：

kubectl get pvc mysql-data-disk

如果PVC状态为Pending，说明集群没有匹配的PV或存储类配置错误，需要先完成存储资源配置再部署应用。

• 镜像拉取规则调整
  你已经在minikube节点手动拉取了mysql:5.7镜像，且配置了imagePullPolicy: IfNotPresent，正常情况下不会重复拉取。如果仍然怀疑镜像拉取问题，可以将拉取策略修改为Never强制使用本地镜像，重新部署即可。

补充排查方向 #

如果上述问题都已排除，可以执行kubectl logs <Pod名称> -c mysql查看容器内部启动日志，定位MySQL应用层面的启动错误。

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