MySQL 8.4 将 SLAVE 全面替换为 REPLICA 是官方术语去敏决策,非功能变更;所有相关变量、命令(如 SHOW SLAVE STATUS 仅警告不报错)、日志及文档均已更新,旧语法保留兼容但须及时迁移脚本、监控与工具以避免告警失效或采集异常。

MySQL 8.4 为什么把 SLAVE 换成 REPLICA
这是官方明确的术语去敏(de-sensitization)决策,不是语法或功能变更。MySQL 8.4 LTS 中所有涉及复制角色的系统变量、状态变量、SQL 语句、错误日志和文档都已将 slave 替换为 replica,例如:slave_parallel_type → replica_parallel_type,SHOW SLAVE STATUS → SHOW REPLICA STATUS。
SHOW SLAVE STATUS 在 MySQL 8.4 执行会报错吗
不会直接报错,但会触发警告,并建议改用新语法:
mysql> SHOW SLAVE STATUS\G Warning (Code 1287): 'SHOW SLAVE STATUS' is deprecated and will be removed in a future MySQL version. Please use SHOW REPLICA STATUS instead.
- 兼容性保留:旧命令仍可运行,仅发
Warning,不中断执行 - 客户端工具(如
mysqldump、pt-heartbeat)若硬编码SHOW SLAVE STATUS,会在日志中持续刷 Warning,可能掩盖真正问题 - Percona Toolkit 3.5+、Sysbench 1.0.20+ 已适配
SHOW REPLICA STATUS;老版本需升级或打补丁
哪些配置项和变量名必须更新
以下关键项在 MySQL 8.4 中已废弃旧名,新部署或升级后应主动替换,否则可能被未来版本彻底移除:
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
- 系统变量:
slave_parallel_workers→replica_parallel_workers - 状态变量:
Slave_running→Replica_running(注意大小写) - 启动选项:
--relay-log-info-file未变,但相关内部注释和 error log 中的上下文描述已统一为replica - performance_schema 表:
replication_connection_status和replication_applier_status替代原slave_*前缀表(slave_master_info等仍存在,但标记为 deprecated)
升级到 MySQL 8.4 后脚本和监控要不要改
要改,尤其对自动化运维场景——看似只是字符串替换,但漏掉一处就可能让告警失效或数据采集为空:
- Shell/Python 脚本里匹配
Slave_IO_Running: Yes的正则,需同步改为Replica_IO_Running: Yes - Zabbix/Prometheus exporter 若解析
SHOW SLAVE STATUS输出,必须切换命令并重写字段映射逻辑 - Ansible playbook 中使用
mysql_replication模块时,参数mode: slave已弃用,应改用mode: replica(取决于模块版本) - MySQL Router 8.4 默认以
replica为内部角色标识,与旧版 Router 混用时可能出现元数据不一致
最易忽略的是 error log 里的关键词搜索——比如用 grep "Slave SQL thread" 查延迟,现在得改成 grep "Replica SQL thread",否则查不到任何记录。

















