必须用StatefulSet+Headless Service+volumeClaimTemplates将MySQL数据目录挂载到ReadWriteOnce持久卷，禁用Delete回收策略，迁移需mysqldump导入并修正权限与认证插件。
不能直接把物理机或虚拟机上的 MySQL 数据目录打包塞进容器里跑 —— Pod 重启后路径丢失、权限错乱、InnoDB 崩溃是大概率事件。必须用 Kubernetes 原生的持久化机制重走一遍数据路径，核心是让 /var/lib/mysql 挂载到有状态、可绑定、不随 Pod 生命周期消失的存储上。
StatefulSet 是唯一可行的控制器
Deployment 会随机调度、复用 PVC，MySQL Pod 重建后可能挂上别人的数据卷，轻则启动失败，重则数据覆盖。StatefulSet 才能保证：mysql-0 永远绑定自己的 PVC，名字、网络标识、存储一一对应。
- 必须定义
serviceName（Headless Service），否则 StatefulSet 无法生成稳定的 DNS 记录（如mysql-0.mysql-headless.default.svc.cluster.local） -
volumeClaimTemplates要写在 StatefulSet spec 里，不是单独的 PVC 清单 —— 这样才能自动为每个副本生成带序号的 PVC（如mysql-data-mysql-0） - 不要设
replicas > 1单纯为了“高可用”：MySQL 主从不是靠多副本自动实现的，没做复制配置前多个 Pod 同时写同一份数据会直接损坏
PVC 必须匹配 MySQL 的访问模式
MySQL 容器默认以 UID 999（mysql 用户）写入 /var/lib/mysql，且只允许单节点读写。所以 PVC 的 accessModes 只能是 ReadWriteOnce，否则调度失败或挂载后权限拒绝。
-
ReadWriteMany看起来“更灵活”，但 NFS 等共享存储在并发写 InnoDB 日志时极易触发锁冲突或元数据损坏，生产环境禁用 - 如果用本地盘（
hostPath或localPV），必须配nodeAffinity锁定调度节点，否则 Pod 被调度到无对应 PV 的节点就卡在Pending -
storageClassName必须显式指定，空字符串或留空会触发默认 StorageClass —— 而默认类往往配的是ReadWriteMany，导致 PVC 一直Pending
初始化迁移要绕过容器内自动生成数据流程
直接用 mysql:8.0 镜像启动，容器会检测 /var/lib/mysql 为空，自动执行 mysqld --initialize 生成新 root 密码和系统表 —— 你导入的旧数据会被忽略甚至破坏。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录，或需要将该能力封装成可公开复用的 Codex skill。
- 迁移前先停掉源库，用
mysqldump --all-databases --single-transaction导出，别用cp -r /var/lib/mysql - 在目标 PVC 对应的宿主机目录（如 NFS 共享路径或本地
/k8sVolume/mysqlVolume/mypv1）手动清空，再用mysql客户端连进去执行SOURCE /path/to/dump.sql - 或者改用初始化容器（
initContainer）：在主容器启动前，用另一个镜像（如mysql:8.0+sleep infinity）挂载同一 PVC，手动导入 dump 文件，再退出 - 务必检查导入后
mysql.user表里的plugin字段，老版本用mysql_native_password，新镜像默认用caching_sha2_password，应用连接会报Authentication plugin 'caching_sha2_password' cannot be loaded
StorageClass 的 reclaimPolicy 别设成 Delete
线上环境一旦误删 PVC，reclaimPolicy: Delete 会让底层 PV 和真实数据一并清除 —— 不是“回收”，是物理删除。MySQL 这种核心数据，必须设 Retain。
-
Retain下，删 PVC 后 PV 进入Released状态，数据还在，但需手动kubectl patch pv xxx -p '{"spec":{"claimRef":null}}'才能重新绑定新 PVC - 动态供应的云盘（如 AWS EBS、阿里云云盘）默认
ReclaimPolicy是Delete，创建 StorageClass 时必须显式覆盖 - NFS 类 StorageClass 无法真正“删除”数据，
Recycle已被弃用（v1.25+），强行使用会报错，统一用Retain+ 人工清理更可控
最常被跳过的一步：验证 PVC 绑定后，进容器 ls -l /var/lib/mysql 看文件属主是不是 mysql:mysql（UID/GID 999）。不是的话，InnoDB 初始化会失败，日志里只有 mysqld: Can't create/write to file 这种模糊报错 —— 得提前在 PV 目录里 chown -R 999:999。
