Kubernetes StatefulSet部署MySQL遇CrashLoopBackOff问题求助

1. 优先查看容器崩溃日志 #

直接获取上次崩溃的完整日志，定位核心错误：

kubectl logs <mysql-statefulset-pod-name> --previous

重点关注：权限报错（如Permission denied）、数据目录初始化失败、配置文件路径错误、版本兼容性提示等关键信息。

2. 检查PV挂载目录的权限 #

MySQL容器默认使用UID=999的mysql用户运行，若PV挂载到节点的目录权限不匹配，会导致进程无法读写数据直接崩溃：

# 1. 找到Pod所在节点和PV的宿主路径
kubectl describe pod <mysql-pod-name> | grep -A5 "Node:"
kubectl describe pv <target-pv-name> | grep "Path:"

# 2. 登录节点查看目录权限
ls -ld <pv-host-path>

如果权限非999:999，直接修正：

chown -R 999:999 <pv-host-path>

也可以在StatefulSet的容器配置中添加安全上下文强制适配：

securityContext:
  runAsUser: 999
  runAsGroup: 999
  fsGroup: 999

3. 验证StatefulSet核心配置 #

• 确认env字段中已设置MYSQL_ROOT_PASSWORD、MYSQL_DATABASE等必要环境变量，缺失会导致容器启动失败。
• 检查是否自定义了command/args参数，比如错误指定只读模式、配置文件路径无效等。

4. 排查存储资源状态 #

• 在节点上执行df -h <pv-host-path>，确认PV所在磁盘未被占满，磁盘空间不足会导致MySQL无法写入日志或数据。
• 执行dmesg | grep -i error检查节点磁盘是否存在IO故障，存储介质异常也会引发容器反复崩溃。

5. 处理旧数据兼容性问题 #

若PV中残留了原Deployment的MySQL数据，可能存在权限不匹配、版本不兼容问题：

# 先备份数据
tar -czf mysql-backup.tar.gz <pv-host-path>
# 清空目录后重启Pod，让MySQL重新初始化
rm -rf <pv-host-path>/*
kubectl delete pod <mysql-pod-name>

6. 确认StatefulSet存储卷模板配置 #

检查volumeClaimTemplates的核心参数是否符合要求：

volumeClaimTemplates:
- metadata:
    name: mysql-data
  spec:
    accessModes: [ "ReadWriteOnce" ] # MySQL需独占读写权限
    storageClassName: "your-storage-class" # 确保存储类存在
    resources:
      requests:
        storage: 10Gi # 资源请求需匹配实际需求

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