ProxySQL不能自动感知MySQL主从切换,必须依赖外部工具调用Admin接口更新mysql_servers表并执行LOAD/SAVE命令生效,同时需严格校验@@read_only、预置双写组、同步多节点配置。

ProxySQL节点不能自动感知MySQL主从切换
ProxySQL本身不监听MySQL复制状态变更,也不会主动拉取SHOW SLAVE STATUS或replication_group_members。它只按配置的mysql_servers表和mysql_query_rules转发请求——旧主库IP还在表里、status还是ONLINE,写请求照发不误,必然报mysql_connection_error或Lock wait timeout exceeded。
实操建议:
- 必须由外部工具(如Orchestrator、MHA或自研脚本)在完成主从切换后,立刻调用ProxySQL Admin接口更新
mysql_servers:把原主库hostgroup_id从写组(如10)移到只读组(如30),新主库从只读组移回写组,并设weight > 0 - 执行
LOAD MYSQL SERVERS TO RUNTIME生效,再用SELECT * FROM monitor.mysql_server_read_only_log确认新主库read_only=OFF被正确识别 - 禁止依赖“自动发现”:ProxySQL没有
auto_discover机制;DiscoverByShowSlaveHosts是Orchestrator的参数,不是ProxySQL的
升级期间ProxySQL需预置双写组并冻结旧主流量
大版本升级(如5.7→8.0)不是切一次主从就能完事,得先让新集群跑稳再切流。ProxySQL必须提前建好两套hostgroup:旧写组(hostgroup_id=10)、新写组(hostgroup_id=20),否则切流时无处可路由。
实操建议:
- 新集群上线前,在
mysql_servers中插入新主库地址,status='ONLINE'但weight=0,避免被负载均衡选中 - 配一条高优先级
mysql_query_rules:用match_digest匹配USE_NEW_CLUSTER注释,destination_hostgroup=20,apply=1,cache_ttl=0 - 应用发布灰度版本,在事务开头加
/*+ USE_NEW_CLUSTER */,验证新集群读写、GTID同步、字符集排序是否正常 - 切流前务必预热连接池:
mysql -h127.0.0.1 -P6033 -uadmin -padmin -e "SELECT 1"触发ProxySQL与新主库建连,否则首波请求会卡在Too many connections
健康检查必须依赖@@read_only且严格校验返回值
ProxySQL默认用SELECT 1判断节点存活,但这无法区分主从角色。真正决定写流量走向的是SELECT @@read_only结果:返回0才允许进写组。若MySQL配置漏掉super_read_only=ON,或ProxySQL没开mysql-monitor_username权限,就会误判只读实例为可写,引发数据不一致。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
实操建议:
-
monitor.mysql_server_read_only_log必须显示新主库read_only=0且error=NULL;若出现Access denied,说明监控账号缺SELECT权限 - 所有MySQL节点必须显式设
read_only=ON(从库)或OFF(主库),不能靠角色推断;MGR集群还要确保group_replication_single_primary_mode=ON - 禁用
max_replication_lag做写组准入条件——它只对只读组生效;写组唯一可信依据就是@@read_only == 0
多ProxySQL节点配置同步不是“集群”,而是靠外部强一致性保障
所谓“ProxySQL集群”只是多个独立ProxySQL实例共享同一套配置源(如Consul、MySQL元数据库或Git仓库),并非真正的分布式协调。任一节点配置滞后,都会导致部分流量走错路径。
实操建议:
- 用
proxysql-admin或自定义脚本统一推送配置到所有ProxySQL节点,执行顺序必须是:UPDATE mysql_servers→LOAD MYSQL SERVERS TO RUNTIME→SAVE MYSQL SERVERS TO DISK - 不要用
mysql_query_rules的sticky_conn=1跨版本混用——MySQL 8.0的caching_sha2_password握手流程与5.7不同,长连接复用会导致认证失败 - 切流窗口期,临时关闭非关键业务的
mysql_query_rules缓存(rule_id设active=0),避免规则加载延迟掩盖真实路由错误
ProxySQL不是升级的被动接收方,而是需要前置介入的流量控制点。最容易被忽略的其实是weight=0这个哑变量——它不参与负载均衡,却能让你在不动应用的前提下,用注释开关精准控制每条SQL的走向。

















