ProxySQL读写分离需手动配置mysql_query_rules表并加载生效,否则所有SQL走默认hostgroup;须先注册主从到mysql_servers并设对应hostgroup_id,再按顺序插入SELECT FOR UPDATE、普通SELECT和兜底规则,每条active=1且apply=1,最后执行LOAD+SAVE,并开启transaction_persistent保障事务一致性。

ProxySQL 读写分离不会自动生效,必须手动配置 mysql_query_rules 表并加载,否则所有 SQL 都走默认 hostgroup(通常是主库)。
确认后端主从已注册且分组正确
ProxySQL 不会自动识别主从角色,只按 hostgroup_id 路由。必须确保:
- 主库插入到
mysql_servers表时,hostgroup_id设为写组编号(如10),从库统一设为读组编号(如20) - 执行
LOAD MYSQL SERVERS TO RUNTIME后,用SELECT * FROM runtime_mysql_servers检查状态是否为ONLINE - 不要依赖
mysql_replication_hostgroups表自动发现主从——它只辅助健康检测,不参与路由决策
插入两条核心路由规则,顺序不能错
规则按 rule_id 升序匹配,第一条命中即终止。常见错误是把兜底规则放前面,导致所有语句都进写组。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
- 先插带锁读:用
match_digest匹配'^SELECT.*FOR UPDATE$'→destination_hostgroup=10 - 再插普通读:用
match_digest匹配'^SELECT '(注意空格,避免误中SELECTED等词)→destination_hostgroup=20 - 最后补兜底:用
match_pattern匹配'.*'→destination_hostgroup=10,确保事务、INSERT/UPDATE/DELETE 全部落主库 - 每条规则必须设
active=1且apply=1,否则不生效
用户配置要开启事务粘性
否则事务内先 SELECT 再 UPDATE 时,第二次请求可能被路由到从库,报错或读到旧数据。
- 在
mysql_users表中插入用户时,transaction_persistent必须为1 -
default_hostgroup应设为写组(如10),作为未匹配规则时的 fallback,而非读组 - 执行
LOAD MYSQL USERS TO RUNTIME和SAVE MYSQL USERS TO DISK同步配置
规则生效后必须显式加载并持久化
ProxySQL 的三层配置模型(disk / runtime / memory)容易混淆,仅改表不加载等于没改。
- 每次修改
mysql_query_rules后,必须执行:LOAD MYSQL QUERY RULES TO RUNTIME - 再执行:
SAVE MYSQL QUERY RULES TO DISK,否则重启后规则丢失 - 验证是否生效:用
SELECT * FROM stats_mysql_query_rules查看hits计数,或抓包看实际发往哪个后端 IP
最容易被忽略的是规则顺序和 transaction_persistent 开关——这两个点出问题,现象都是“明明写了 SELECT 走读库,结果还是打到主库”,但原因完全不同:前者是正则匹配逻辑错乱,后者是事务上下文被拆开路由。

















