StatefulSet是唯一可行选择,因其保障MySQL每个Pod拥有固定名称(如mysql-0)、专属PVC(如data-mysql-0)及稳定DNS域名(mysql-0.mysql.default.svc.cluster.local),支撑主从握手、GTID同步与客户端连接;Deployment随机命名与共享PVC会导致数据错乱、解析失败。

必须用 StatefulSet,不能用 Deployment;PVC 模板要写在 StatefulSet 里,不能手动生成 PVC;Headless Service 是刚需,否则 Pod 间无法稳定通信。
为什么 StatefulSet 是唯一可行的选择
MySQL 是典型有状态服务:每个实例需要固定身份、专属存储、有序启停。Deployment 生成的 Pod 名是随机哈希(如 mysql-7d8f9b4c6),重启后可能挂载错 PVC,数据错乱甚至丢失。StatefulSet 则保证 mysql-0 永远绑定自己的 PVC,且 DNS 名固定为 mysql-0.mysql.default.svc.cluster.local —— 这是主从握手、GTID 同步、客户端连接的基础。
常见错误现象:
- 用 Deployment 部署后,Pod 重建时连不上原数据目录,报错
Can't open the mysql.plugin table - 主从 Pod 解析不到彼此,
CHANGE MASTER TO执行失败,提示Unknown MySQL server host 'mysql-1' (2)
StatefulSet 中 PVC 模板怎么写才不踩坑
关键在 volumeClaimTemplates 字段:它不是声明一个 PVC,而是定义一个“模板”,Kubernetes 会为每个 Pod(mysql-0、mysql-1…)自动创建一个独立 PVC,并按序号命名(如 data-mysql-0)。手动生成 PVC 再硬绑定,会破坏 StatefulSet 的自动扩缩容能力。
实操建议:
-
storageClassName必须存在且可用,执行kubectl get storageclass确认;若用 NFS,需提前部署nfs-subdir-external-provisioner -
accessModes选ReadWriteOnce即可,MySQL 不支持多写;别误配成ReadWriteMany,多数 StorageClass 不支持 - 不要在 StatefulSet 里写
claimName—— 那是 Deployment 绑定共享 PVC 的写法,放在这里会导致所有 Pod 尝试挂同一个 PVC,启动失败
Headless Service 和 ConfigMap 怎么配合主从逻辑
Headless Service(clusterIP: None)是让 mysql-0 能解析到 mysql-1 的前提。没有它,DNS 只返回 ClusterIP,Pod 之间无法直连。ConfigMap 则用来区分主从配置:不能只靠一个 my.cnf 全局生效,必须用两个文件(如 master.cnf 和 slave.cnf),再通过 initContainer 或启动脚本判断自身序号($HOSTNAME)决定加载哪个。
容易忽略的点:
- ConfigMap 挂载进容器后,
mysqld默认不读取子目录下多个 cnf 文件,得在启动命令中显式指定:mysqld --defaults-file=/etc/mysql/master.cnf - 主从
server-id必须全局唯一,StatefulSet 的序号(0、1)可直接映射为server-id=1、server-id=2,但需在容器内脚本中转换,不能写死 - GTID 复制要求
enforce-gtid-consistency=ON和gtid-mode=ON,缺一不可,否则START SLAVE报错ERROR 3021 (HY000)
健康探针和资源限制怎么设才真实有效
MySQL 容器启动慢(尤其首次初始化),探针配置不当会导致反复重启。Liveness 探针不能只靠 mysqladmin ping,它不验证用户权限和复制状态;Readiness 探针也不能只查端口通不通,得确认是否已接受连接且主从同步无延迟。
推荐做法:
- Liveness:用
exec执行mysql -uroot -p$MYSQL_ROOT_PASSWORD -e "SELECT 1",initialDelaySeconds: 60(给足初始化时间) - Readiness:对从库额外加检查
SHOW SLAVE STATUS\G中Seconds_Behind_Master: 0,避免流量打到不同步的节点 - 内存限制至少设为
1Gi,MySQL 8.0 默认innodb_buffer_pool_size占物理内存 75%,限太低会频繁 OOM
最常被跳过的细节:StatefulSet 的 serviceName 字段必须和 Headless Service 的 metadata.name 完全一致,否则 DNS 域名无法生成 —— 这个名字一旦写错,整个集群就卡在 DNS 解析失败上,连日志都看不出原因。


















