结论:别用replicate-ignore-db,它在MySQL 8.0.26+已弃用且行为不可靠;应优先使用replicate-wild-ignore-table或replicate-do-table,必须写入从库my.cnf并重启mysqld才生效。

直接说结论:别用 replicate-ignore-db,它在 MySQL 8.0.26+ 已弃用,且行为不可靠;优先用 replicate-wild-ignore-table 或 replicate-do-table,必须写进从库 my.cnf 并重启 mysqld 才生效。
为什么 replicate-ignore-db 会失效?
它不看 SQL 里实际操作哪个库,只看当前 session 是否执行过 USE db_name。比如你在 USE app_db 下执行 INSERT INTO log_db.audit_log VALUES (),这条语句仍会被同步——因为“当前库”是 app_db,而 log_db 不在 ignore 列表里,规则根本没触发。
更糟的是:replicate-ignore-db 只对 STATEMENT 格式 binlog 生效;主库设了 binlog_format = ROW(推荐配置),这个参数就完全被忽略。
- 常见错误现象:
SHOW SLAVE STATUS\G显示Replicate_Ignore_DB: tmp_db,但tmp_db里的表仍有数据写入 - ORM 或应用代码常用显式库名语法(如
INSERT INTO monitor.metrics),直接绕过USE上下文 - GTID 模式下,
replicate-ignore-db还可能导致gtid_executed和gtid_purged不一致,后续主库切换失败
replicate-wild-ignore-table 怎么写才真正生效?
这是目前最可控的过滤方式,匹配语句中显式出现的 “库名.表名”,不受 USE 影响,且对 ROW 格式 binlog 有效。
格式必须是 db_name.table_pattern,通配符只作用于表名部分:
-
replicate-wild-ignore-table = logging.%→ 忽略logging库下所有表 -
replicate-wild-ignore-table = app.log_*→ 忽略app库下所有log_开头的表(注意:MySQL 用%,不是*;*是 shell 习惯,这里得写log_%) -
replicate-wild-ignore-table = %.backup_*→ 忽略所有库中以backup_开头的表(%只能用于库名位置,不能写成backup_%)
多个规则写多行,不能用逗号或空格分隔;配置后必须重启 mysqld,再查 SHOW SLAVE STATUS\G 确认 Replicate_Wild_Ignore_Table 字段已更新。
mysqldump 初始化时怎么跳过不需要的库或表?
导出阶段过滤比恢复后删更安全,但 --ignore-table 容易静默失效:
- 必须写全
--ignore-table=dbname.tablename,漏库名(如--ignore-table=users)或写错分隔符(如--ignore-table=dbname\users)都不报错,但无效 - 想跳过整个库?别用
--ignore-table,改用显式列举:mysqldump -u root -p --databases app_db order_db - MySQL 5.7.12+ 支持
--ignore-database=monitoring,但旧版本不兼容,慎用 -
--ignore-table不过滤GRANT语句,如果被忽略表上有独立权限,dump 文件里仍含这些语句,恢复可能报错
验证是否真过滤成功:加 --verbose 参数跑一次,stdout 会打印正在处理哪些表,一眼看出是否被跳过。
GTID 模式下修改过滤规则的致命限制
开启 gtid_mode = ON 后,所有复制过滤参数(包括 replicate-wild-ignore-table)必须在从库首次启动复制前就写进 my.cnf。运行中执行 SET GLOBAL replicate_wild_ignore_table = 'logging.%' 会直接报错:Variable 'replicate_wild_ignore_table' is a read only variable。
这意味着:
- 不能动态添加或删除过滤规则
- 改配置必须停复制、改文件、重启 mysqld、重置复制链路(
RESET SLAVE+CHANGE REPLICATION SOURCE TO) - 如果从库已同步了不该有的表,过滤规则只对新事件生效,旧数据得手动
DROP TABLE清理
最容易被忽略的一点:binlog_format 隐性决定过滤能力——主库设 ROW,replicate-ignore-db 和 replicate-do-db 就彻底失效,你却可能还在调试它们。


















