mysql多源复制必须使用table模式存储元数据,for channel为强制语法且不可为空,各通道需独立启停与监控,否则静默失败。

FOR CHANNEL 是强制的,漏写、错写或留空都会导致通道静默失败——它不报错,但根本不会启动。
必须先设 master_info_repository 和 relay_log_info_repository 为 TABLE
MySQL 5.7 多源复制不支持 FILE 模式,否则执行 CHANGE REPLICATION SOURCE TO ... FOR CHANNEL 会直接报错:ERROR 3077 (HY000): To have multiple channels, repository cannot be of type FILE。动态修改前必须停掉所有复制线程:STOP REPLICA(注意:5.7.28+ 已弃用 STOP SLAVE),再执行:
SET GLOBAL master_info_repository = 'TABLE';SET GLOBAL relay_log_info_repository = 'TABLE';
确认生效:SHOW VARIABLES LIKE '%repository%';,两个值都应为 TABLE。这步不能跳过,哪怕你只加第二个通道。
CHANGE REPLICATION SOURCE TO 必须带显式非空 FOR CHANNEL
5.7.17+ 统一使用 SOURCE 术语(MASTER 已弃用),且 FOR CHANNEL 是强制语法。常见错误包括:
- 漏写
FOR CHANNEL:会被当作默认通道,覆盖前一个配置 -
FOR CHANNEL ''(空名):非法,等同于不指定,仍走默认通道 - 通道名含点、短横、空格:如
'order.db'或'master-1',会导致解析失败
正确示例:CHANGE REPLICATION SOURCE TO SOURCE_HOST='192.168.1.101', SOURCE_USER='rpl', SOURCE_PASSWORD='pwd', SOURCE_LOG_FILE='mysql-bin.000001', SOURCE_LOG_POS=154 FOR CHANNEL 'order_master';。通道名建议用有意义的下划线命名,如 'user_master',避免 'a'、'b' 这类易混淆简写。
START REPLICA 和 SHOW REPLICA STATUS 必须按通道指定
这是最常踩的坑:执行完所有 CHANGE ... FOR CHANNEL 后,只敲一次 START REPLICA,结果只有默认通道(空名)在跑,其他通道完全不动——SHOW REPLICA STATUS 根本不显示它们。
- 启动单个通道:
START REPLICA FOR CHANNEL 'order_master'; - 查看指定通道状态:
SHOW REPLICA STATUS FOR CHANNEL 'order_master'\G(加\G才能看清字段) - 停止单个通道:
STOP REPLICA FOR CHANNEL 'user_master';
没有“启动全部通道”的命令;START REPLICA 不带 FOR CHANNEL 只影响默认通道。
不同通道的 relay-log 文件前缀必须唯一
多个通道若共用默认 relay-log 前缀(如都用 relay-bin),会导致中继日志文件冲突,复制中断。必须为每个通道显式指定独立前缀:
- 在配置文件中设通用基础名:
relay-log = relay-bin(仅作前缀基底) - 在
CHANGE REPLICATION SOURCE TO中为每个通道指定完整路径+前缀:RELAY_LOG_FILE='relay_order.000001' FOR CHANNEL 'order_master';
更稳妥的做法是:在 my.cnf 中直接为每个通道预设前缀(通过 CHANGE ... RELAY_LOG_FILE 动态设置),避免依赖默认行为。
ERROR 1050 (42S01): Table 'xxx' already exists。这不是参数能绕过的,得靠人工规划库表命名或前置过滤。











