Kubernetes部署MySQL遇/var/lib/mysql不可用错误求修复及数据持久化方案

错误原因 #

挂载到/var/lib/mysql的Kubernetes存储卷中存在残留文件（可能是之前部署的遗留文件、存储卷初始化生成的默认文件），MySQL启动时检测到数据目录非空，而初始化流程要求目录为空，因此触发报错终止。

修复步骤 #

1. 清理存储卷中的旧文件 #

• 无重要数据场景：直接删除对应PersistentVolumeClaim（PVC）重建，数据会被清空，适合测试环境：

  kubectl delete pvc <你的MySQL PVC名称>
  

• 需保留数据场景：创建临时Pod挂载存储卷，清理MySQL初始化生成的系统文件（不要删除业务数据）：
  创建临时清理Pod的YAML文件temp-cleanup.yaml：

  apiVersion: v1
  kind: Pod
  metadata:
    name: temp-mysql-cleanup
  spec:
    containers:
    - name: busybox
      image: busybox:latest
      command: ["sh", "-c", "rm -rf /var/lib/mysql/ibdata1 /var/lib/mysql/ib_logfile* /var/lib/mysql/mysql /var/lib/mysql/performance_schema && exit"]
      volumeMounts:
      - name: mysql-data
        mountPath: /var/lib/mysql
    volumes:
    - name: mysql-data
      persistentVolumeClaim:
        claimName: <你的MySQL PVC名称>
    restartPolicy: Never
  

  执行清理：

  kubectl apply -f temp-cleanup.yaml
  

  清理完成后删除临时Pod：

  kubectl delete pod temp-mysql-cleanup
  

2. 调整MySQL启动配置 #

• 不要在容器启动命令中手动添加--initialize参数，官方MySQL镜像会自动判断数据目录是否为空：为空则执行初始化，非空则直接加载现有数据。
• 若使用自定义镜像，检查启动脚本逻辑，确保仅在/var/lib/mysql为空时执行初始化操作。

正确的MySQL持久化部署示例 #

以下是包含PVC和Deployment的完整配置，确保数据持久化且重启/重部署后保留数据：

# MySQL 持久化存储声明
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: mysql-pvc
spec:
  accessModes:
    - ReadWriteOnce  # 单节点读写，适合MySQL单实例场景
  resources:
    requests:
      storage: 10Gi  # 根据实际需求调整存储大小
---
# MySQL Deployment
apiVersion: apps/v1
kind: Deployment
metadata:
  name: mysql
spec:
  replicas: 1
  selector:
    matchLabels:
      app: mysql
  template:
    metadata:
      labels:
        app: mysql
    spec:
      containers:
      - name: mysql
        image: mysql:8.0  # 使用稳定版本镜像
        env:
        - name: MYSQL_ROOT_PASSWORD
          value: "your-secure-password"  # 替换为实际密码
        - name: MYSQL_DATABASE
          value: "your-db-name"  # 可选：自动创建初始数据库
        ports:
        - containerPort: 3306
        volumeMounts:
        - name: mysql-data
          mountPath: /var/lib/mysql  # 挂载数据目录
      volumes:
      - name: mysql-data
        persistentVolumeClaim:
          claimName: mysql-pvc  # 关联上面创建的PVC

关键注意事项 #

• 第一次启动时，MySQL会自动初始化/var/lib/mysql目录并创建系统表，后续重启或重新部署Pod时，因目录已有数据，会直接加载现有数据，不会触发初始化。
• 除非确定不再需要数据，否则不要随意删除PVC，PVC绑定的PersistentVolume（PV）数据会保留（除非PV的回收策略设置为Delete）。

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