先确认并行复制线程是否真正启动:执行 STOP REPLICA; START REPLICA; 后查 SHOW PROCESSLIST,可见多个 system user 线程状态为 “Waiting for an event from Coordinator” 或 “Executing event”;再查 performance_schema.replication_applier_status_by_worker 和 replication_applier_status_by_coordinator,观察 WORKERS_WAITING > 0 或 LAST_APPLIED_TRANSACTION 滞后等指标,结合 SHOW REPLICA STATUS 中 Seconds_Behind_Master 与 GTID 差值综合判断。

怎么查 replica_parallel_workers 是否生效
先确认并行复制线程是否真正启动了,而不是只改了配置。MySQL 8.0 中并行复制依赖 replica_parallel_workers 和 replica_preserve_commit_order 两个关键参数协同工作:
-
SET GLOBAL replica_parallel_workers = 4;设置后,必须重启复制(STOP REPLICA; START REPLICA;)才生效,仅改参数不重启,SHOW PROCESSLIST里看不到额外的 worker 线程 -
replica_preserve_commit_order = ON是开启基于 WRITESET 或 LOGICAL_CLOCK 并行调度的前提;设为OFF时,即使replica_parallel_workers > 0,SQL 线程仍退化为单线程执行 - 检查是否启用 WRITESET:主库需设
binlog_transaction_dependency_tracking = WRITESET,且从库replica_parallel_type = LOGICAL_CLOCK(MySQL 8.0.26+ 默认值)
怎么看正在等待的并行事件队列
MySQL 不提供“当前等待中事件”的直接视图,但可通过以下方式间接判断并行调度是否卡在依赖等待上:
- 查
performance_schema.replication_applier_status_by_coordinator:重点关注APPLYING_EVENT状态下WORKERS_PROCESSED和WORKERS_WAITING字段 —— 若后者长期 > 0,说明有 worker 因事务依赖(如 WRITESET 冲突)被阻塞 - 查
performance_schema.replication_applier_status_by_worker:每行对应一个 worker,看LAST_APPLIED_TRANSACTION和LAST_APPLIED_TRANSACTION_ORIGINAL_COMMIT_TIMESTAMP是否明显滞后于 coordinator,滞后越大,越可能在等前置事务提交 - 结合
SHOW REPLICA STATUS\G中的Seconds_Behind_Master和Retrieved_Gtid_Set/Executed_Gtid_Set差值,若 GTID 差很多但 Seconds_Behind_Master 很小,大概率是并行 worker 在空转等依赖,而非真正在执行
为什么 SHOW PROCESSLIST 看不到“等待事件”字样
MySQL 的并行 worker 线程在 SHOW PROCESSLIST 中统一显示为 system user,状态字段固定为 Waiting for an event from Coordinator 或 Executing event,不会显示具体等哪个事务或哪行数据。这是设计使然,不是你漏看了:
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
- 状态为
Waiting for an event from Coordinator表示该 worker 当前无任务可做,正在等 coordinator 分发新事件 —— 这本身不异常,反而是负载低的表现 - 真正要警惕的是所有 worker 都卡在
Waiting for preceding transaction to commit(该状态只出现在 performance_schema 视图中,不在 PROCESSLIST) - 如果发现多个 worker 长期处于
Executing event但整体延迟不降,大概率是某条大事务或 DDL 占用了 coordinator 线程,导致分发停滞
容易被忽略的兼容性坑
并行复制不是开个参数就一劳永逸,几个硬性前提常被跳过:
- 主库
binlog_format必须是ROW;STATEMENT模式下replica_parallel_workers完全无效 - 从库
relay_log_info_repository和master_info_repository必须设为TABLE,否则并行复制元数据无法持久化,重启后退化为单线程 - GTID 模式下,
replica_parallel_type必须是LOGICAL_CLOCK;传统 file:pos 模式下只能用DATABASE级别并行(已废弃,不推荐) - 写集合(WRITESET)依赖主库
transaction_write_set_extraction = XXHASH64,且表必须有主键或非空唯一键,否则 WRITESET 生成失败,退回到单线程回放
真实线上环境里,并行复制的“等待”往往藏在 coordinator 的调度逻辑和 WRITESET 冲突检测里,而不是某个显眼的错误日志。盯住 performance<em>schema</em> 里的那几张 replication* 表,比反复刷 SHOW PROCESSLIST 有用得多。

















