MySQL主从权限默认不同步,因mysql.user变更不写入binlog或被replicate_ignore_db=mysql跳过;必须人工用CREATE USER+GRANT、导出导入或pt-show-grants同步,严禁直改系统表。

MySQL主从复制环境下,从库不会自动同步用户权限 —— 这不是 bug,也不是配置遗漏,而是 MySQL 的明确设计行为。所有对 mysql.user 表的变更(包括 CREATE USER、GRANT、DROP USER)默认不进入 binlog,或即使进入也会被复制线程主动跳过。
replicate_ignore_db=mysql 是最常被忽略的硬性过滤
绝大多数生产环境(尤其是通过 Ansible、Docker 镜像或云数据库模板部署的实例)会在从库配置中默认写入 replicate_ignore_db = mysql。这个配置会让 SQL 线程直接丢弃所有涉及 mysql 库的事件,不管主库是否真的写了 binlog。
- 执行
SHOW SLAVE STATUS\G,检查Replicate_Ignore_DB字段是否包含mysql;若存在,权限语句根本不会被读取 - 该配置在从库生效,和主库无关;即使主库
log_bin=ON且binlog_format=ROW,也无济于事 - GTID 模式下同样适用:哪怕主库生成了事务,从库仍会因该规则静默跳过
GRANT 在主库执行了,但从库 SELECT user,host FROM mysql.user 返回空
这是权限未同步的最直接信号。根本原因不是语句没执行,而是它没进复制流水线:
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
- MySQL 5.7 及更早版本:
GRANT默认不记 binlog,除非显式开启log_bin_trust_function_creators=1且 binlog_format 为ROW或MIXED - MySQL 8.0+:虽默认记录 DDL,但前提是主库未关闭
log_bin,且从库未配置replicate_ignore_db=mysql -
INSERT INTO mysql.user或UPDATE mysql.user不仅无效,还会导致从库回放失败(报错ERROR 1786 (HY000): Statement violates GTID consistency)
为什么不能靠 FLUSH PRIVILEGES 解决
FLUSH PRIVILEGES 只是重载内存中的权限缓存,它不产生任何 binlog 事件,也不触发复制。在从库执行它,最多让“已存在的权限”即时生效,但无法凭空造出主库上新建的用户。
- 主库执行
CREATE USER 'u'@'%' IDENTIFIED BY 'p'; GRANT SELECT ON db.* TO 'u'@'%';后,权限已自动加载,无需FLUSH PRIVILEGES - 从库若延迟较大,可临时执行一次
FLUSH PRIVILEGES辅助确认,但这不是同步手段,也不能修复缺失的用户记录 - 若从库连
mysql.user表都查不到该用户,说明数据行根本没进来,FLUSH PRIVILEGES完全无效
真正能落地的权限同步路径只有人工干预
没有“打开某个开关就自动同步”的方案。必须选一种方式并持续执行:
- 导出导入(最稳妥):主库运行
mysqldump --single-transaction --skip-triggers --databases mysql > mysql_privs.sql,删掉general_log、slow_log等非权限表,停掉从库SQL_THREAD后导入 - 复刻 GRANT 语句(推荐用于 8.0+):主库用
SELECT CONCAT('CREATE USER ...')生成语句,过滤系统账户(如mysql.infoschema),在从库用SET SQL_LOG_BIN = 0;关闭 binlog 后执行 - 用
pt-show-grants:Percona Toolkit 工具能生成带角色、SSL、资源限制的完整权限语句,避免手写遗漏
复杂点在于:权限同步不是一次性任务,而是一个需嵌入运维流程的常态化动作。最容易被忽略的是——每次新部署从库、MHA 切换、容器重建后,都得重新做一遍权限对齐,否则第一个连从库的应用就会报 Access denied for user。

















