
MySQL主从在K8s里为什么不能只靠StatefulSet自动发现
因为MySQL主从不是无状态服务,从库必须明确知道主库的host:port和复制账户凭证,而K8s原生Service不提供“谁是主、谁是从”的角色感知能力。StatefulSet能保证Pod有序启停和稳定网络标识,但不会自动配置CHANGE REPLICATION SOURCE TO语句——这步必须人工或脚本介入。
常见错误现象:Slave_IO_Running: No,日志里反复出现ERROR 2003 (HY000): Can't connect to MySQL server,本质是Pod启动后没正确指向主库IP,或者主库还没就绪就去连。
- 主库Pod必须先完全就绪(
mysqld进程监听3306且能执行SQL),从库才开始初始化复制 - 不要用ClusterIP Service做主库入口:从库需要的是主库Pod的固定DNS名(如
mysql-0.mysql),不是Service的虚拟IP - 复制账户必须允许从任意Pod IP连接(
'repl'@'%'),不能限定为'repl'@'mysql-1.mysql'——后者在滚动更新时会失效
initContainer里执行CHANGE REPLICATION SOURCE TO的安全边界
很多方案把复制配置逻辑塞进initContainer,但这里极易出错:initContainer运行时,MySQL容器可能还没完成初始化(比如mysql_install_db还在跑),直接连3306会失败;或者凭据文件权限不对,导致mysql -u root -p...读不到密码。
使用场景:适用于主库已稳定运行、从库首次加入集群,或从库Pod重建后需重新拉取binlog位置。
- initContainer里必须加健康检查循环,直到
mysqladmin ping -h mysql-0.mysql -P 3306 --silent返回0 - 复制命令要用
mysql --defaults-file=/etc/mysql/repl.cnf -e "CHANGE REPLICATION SOURCE TO ...",避免密码明文出现在ps输出里 -
source_host必须写成Headless Service下的Pod DNS名(如mysql-0.mysql),不能写Service名(mysql)或硬编码IP
my.cnf里server-id和log-bin为什么不能全集群统一
MySQL复制要求每个节点server-id全局唯一,否则从库会拒绝连接或产生不可预测的binlog跳过。K8s里如果所有Pod共用同一份ConfigMap,server-id必然重复,导致SHOW SLAVE STATUS里Seconds_Behind_Master一直为NULL。
性能影响:log-bin开启是必须的,但binlog_format=ROW比STATEMENT更安全(避免函数、时间相关语句复制不一致),不过会产生更大日志体积。
- 用Downward API把Pod序号注入配置:在
my.cnf里写server-id = ${HOSTNAME##*-},配合envFrom从downwardAPI加载HOSTNAME -
log-bin路径必须指向空目录(如/var/lib/mysql/logs),且该目录要挂载到持久卷,否则重启后binlog丢失,从库无法续传 - 禁用
skip-networking——K8s内网通信依赖TCP,关了就只能本地socket连
PVC如何避免主从切换后数据错乱
MySQL主从不是高可用自动故障转移方案。如果强行用Probe触发主从倒换(比如主库Pod被删,让某个从库升主),旧主库PVC里的数据会变成“脏状态”,再启动时可能因GTID或binlog位置冲突导致复制中断。
容易踩的坑:用ReadWriteOnce PVC给所有Pod共享——MySQL不支持多实例并发写同一份数据文件,轻则启动失败,重则损坏InnoDB页。
- 每个Pod必须绑定独立PVC(通过volumeClaimTemplates实现),主库和从库的数据目录物理隔离
- 不要在StatefulSet里设置
revisionHistoryLimit: 0:保留旧版本PVC可追溯问题,删除后无法回滚到上一版数据快照 - 备份必须从主库发起(
mysqldump --single-transaction --master-data=2),从库备份可能因复制延迟导致不一致
最麻烦的地方在于:K8s本身不理解MySQL复制协议,所有角色判定、binlog位点校验、failover决策都得自己写Operator或脚本兜底。哪怕用Helm chart一键部署,也得盯着show slave status\G里的Seconds_Behind_Master和Retrieved_Gtid_Set是否持续增长。











