6
0
0

MySQL 8.0 / 8.4 主从复制与验证

2026-11-17
2026-11-17
MySQL 8.0 / 8.4 主从复制与验证
文章摘要
|

一、版本选型

1.1 版本状态(截至 2026-11)

版本

本文锚定

官方支持状态

建议

MySQL 8.0

8.0.46(要求 ≥ 8.0.26)

2026-04 起进入 Sustaining Support,8.0.46 为最终版本(EOL),不再有新补丁

仅用于存量环境维护,新项目不要选

MySQL 8.4 LTS

8.4.11

Premier Support 至 2029-04,Extended 至 2032-04

推荐,长期支持

8.0 版本必须 ≥ 8.0.26,因为本文两版统一使用 8.0.26 引入的 replica_* / source_* 术语;若你的 8.0 更早,需把 log_replica_updates、replica_parallel_workers、replica_preserve_commit_order 换回对应的旧术语参数。

1.2 环境规划(两套方案共用)

主机 IP

角色

server_id

端口

主机证书

10.0.0.145

source(主库)

145

3306

server-145-cert.pem

10.0.0.146

replica(从库)

146

3306

server-146-cert.pem

  • 数据目录:/var/lib/mysql(保持默认);binlog / relaylog:/data/mysql/logs;备份:/backup;证书:/etc/mysql/ssl

  • root 口令:YOUR_PASSWORD

  • 复制账号:repluser / YOUR_PASSWORD,host 精确到 '10.0.0.146'(不使用网段通配)

  • 测试库:repl_verify(仅用于验证,验证完可保留用于心跳)

1.3 凭据约定

所有命令以系统 root 执行;MySQL 客户端统一通过 /root/.my.cnf 读取口令,禁止在命令行出现明文口令、禁止把口令写进全局 profile 脚本。文中 $M 表示:

M="mysql --defaults-extra-file=/root/.my.cnf"

1.4 8.0 与 8.4 的关键差异

能力

MySQL 8.0(≥ 8.0.26)

MySQL 8.4 LTS

配置复制

CHANGE REPLICATION SOURCE TO(8.0.23+)

仅 CHANGE REPLICATION SOURCE TO

复制选项

SOURCE_*(8.0.23+ 引入,旧名仍可用但弃用)

仅 SOURCE_*,MASTER_* 全部移除

启动 / 停止 / 状态

START REPLICA / STOP REPLICA / SHOW REPLICA STATUS(8.0.26+ 别名,旧名仍可用)

仅新名,旧名是语法错误

主库位点

SHOW MASTER STATUS

SHOW BINARY LOG STATUS

清空日志与 GTID 历史

RESET MASTER

RESET BINARY LOGS AND GTIDS

系统变量

replica_* / source_* 为 8.0.26 新增别名,旧名共存

旧术语参数已移除

复制权限名

REPLICATION SLAVE

REPLICATION SLAVE(未改名)

认证插件

默认 caching_sha2_password;mysql_native_password 已弃用但仍可用

默认 caching_sha2_password;mysql_native_password 默认禁用,需 --mysql-native-password=ON

binlog

默认关闭,必须显式 log_bin

默认开启,仍建议显式指定路径

GTID

默认 OFF

默认 OFF

SHOW REPLICA STATUS 输出列名

Master_Host / Slave_IO_Running / Seconds_Behind_Master

Source_Host / Replica_IO_Running / Seconds_Behind_Source

mysqldump 位点参数

--source-data(8.0.26+;内部调用 SHOW MASTER STATUS)

--source-data(内部调用 SHOW BINARY LOG STATUS)

元数据仓库

固定 TABLE,master_info_repository 等已弃用

固定 TABLE,相关变量已移除

8.4 已移除的旧语句(写了就报语法错误):START SLAVE、STOP SLAVE、SHOW SLAVE STATUS、SHOW SLAVE HOSTS、RESET SLAVE、CHANGE MASTER TO、RESET MASTER、SHOW MASTER STATUS、PURGE MASTER LOGS、SHOW MASTER LOGS。

易错澄清:网上(含 AWS RDS 文档)有「8.4 起用 REPLICATION REPLICA 授权」的说法。社区版 MySQL 8.4 的官方静态权限表仍是 REPLICATION SLAVE,动态管理权限是 REPLICATION_SLAVE_ADMIN;

二、通用前置准备

2.1 主机基础

# 时间同步是复制与 GTID 的前提
timedatectl set-timezone Asia/Shanghai
systemctl enable --now chrony            # RHEL 系为 chronyd
chronyc sources -v | tail -5

# 目录与属主
install -d -o mysql -g mysql -m 750 /data/mysql/logs /backup
install -d -o mysql -g mysql -m 700 /etc/mysql/ssl

# 确认版本符合锚定要求
mysqld --version

2.2 AppArmor(Ubuntu 22.04 / 24.04 必做)

把 binlog 放到 /data 后,若不放行,mysqld 启动会报 Permission denied:

AA=/etc/apparmor.d/usr.sbin.mysqld
AA_LOCAL=/etc/apparmor.d/local/usr.sbin.mysqld
ls -l "$AA" "$AA_LOCAL" 2>/dev/null

# 优先写 local include(不会被包升级覆盖);若主文件没有 include,则直接改主文件
grep -q 'local/usr.sbin.mysqld' "$AA" && TARGET="$AA_LOCAL" || TARGET="$AA"
grep -q '/data/mysql/logs/' "$TARGET" || cat >> "$TARGET" <<'EOF'
  /data/mysql/logs/ r,
  /data/mysql/logs/** rwk,
EOF
apparmor_parser -r "$AA"
aa-status | grep mysqld

若主文件使用 include if exists <local/usr.sbin.mysqld>,规则写进 local 文件即可;rwk 中的 k 允许文件加锁,是 MySQL 官方建议的写法。

2.3 生成并分发 TLS 证书(必需)

复制流量包含全部业务数据;caching_sha2_password 在未加密连接上还需索取服务端公钥(有中间人风险)。启用 TLS 后两个问题一起解决。

在一台可信机器上生成自签 CA 与两台服务端证书(SAN 必须包含 IP,否则 SOURCE_SSL_VERIFY_SERVER_CERT=1 会失败):

cd /etc/mysql/ssl
openssl genrsa 4096 > ca-key.pem
openssl req -new -x509 -nodes -days 3650 -key ca-key.pem -out ca.pem \
  -subj "/CN=MySQL-Replication-CA"

for pair in "145:10.0.0.145" "146:10.0.0.146"; do
  id=${pair%%:*}; ip=${pair##*:}
  openssl req -newkey rsa:2048 -nodes -days 3650 \
    -keyout server-${id}-key.pem -out server-${id}-req.pem -subj "/CN=mysql-${id}"
  printf "subjectAltName=IP:%s\n" "$ip" > san-${id}.cnf
  openssl x509 -req -in server-${id}-req.pem -days 3650 \
    -CA ca.pem -CAkey ca-key.pem -set_serial 100${id} \
    -extfile san-${id}.cnf -out server-${id}-cert.pem
done

openssl verify -CAfile ca.pem server-145-cert.pem server-146-cert.pem
openssl x509 -in server-145-cert.pem -noout -text | grep -A1 "Subject Alternative Name"

分发到两台机器(主库用 145 证书,从库用 146 证书,ca.pem 两台都要):

scp ca.pem server-145-cert.pem server-145-key.pem root@10.0.0.145:/etc/mysql/ssl/
scp ca.pem server-146-cert.pem server-146-key.pem root@10.0.0.146:/etc/mysql/ssl/

# 两台机器上都执行
chown -R mysql:mysql /etc/mysql/ssl
chmod 600 /etc/mysql/ssl/*-key.pem /etc/mysql/ssl/ca-key.pem 2>/dev/null
chmod 644 /etc/mysql/ssl/ca.pem /etc/mysql/ssl/*-cert.pem
chmod 700 /etc/mysql/ssl

2.4 客户端凭据文件(两台都执行)

install -m 600 /dev/null /root/.my.cnf
cat > /root/.my.cnf <<'EOF'
[client]
user=root
password=YOUR_PASSWORD
socket=/var/run/mysqld/mysqld.sock
EOF
chmod 600 /root/.my.cnf

mysql --defaults-extra-file=/root/.my.cnf -e "SELECT VERSION(), @@server_id;"

口令写在 600 权限的 option file 里,不会出现在 ps / shell history / 全局可读的 profile 脚本中。若口令含 # 或 ;,需要加引号。--defaults-extra-file 必须是第一个参数。

2.5 防火墙与连接检查

# 主库:只允许从库连 3306
ufw allow from 10.0.0.146 to any port 3306 proto tcp
# 从库:允许主库(主从切换后反向复制)
ufw allow from 10.0.0.145 to any port 3306 proto tcp
ufw reload

# 从库上验证 TCP 可达
nc -zv 10.0.0.145 3306

三、方案 A:MySQL 8.0.46(≥ 8.0.26)

1. 主库配置 /etc/mysql/mysql.conf.d/mysqld.cnf

先备份:cp /etc/mysql/mysql.conf.d/mysqld.cnf{,.bak}。以下为 [mysqld] 段的完整必要项,请合并进现有文件,不要追加到文件末尾(末尾可能已不属于 [mysqld] 段)。

[mysqld]
# ---- 身份与网络 ----
server_id                 = 145
bind_address              = 0.0.0.0
port                      = 3306
skip_name_resolve         = ON

# ---- 二进制日志 ----
log_bin                   = /data/mysql/logs/binlog
binlog_format             = ROW
binlog_row_image          = FULL
binlog_expire_logs_seconds = 604800
max_binlog_size           = 1G
sync_binlog               = 1

# ---- GTID ----
gtid_mode                 = ON
enforce_gtid_consistency  = ON

# ---- 持久性 ----
innodb_flush_log_at_trx_commit = 1

# ---- TLS ----
ssl_ca                    = /etc/mysql/ssl/ca.pem
ssl_cert                  = /etc/mysql/ssl/server-145-cert.pem
ssl_key                   = /etc/mysql/ssl/server-145-key.pem
require_secure_transport  = ON

require_secure_transport=ON 会拒绝所有非 TLS 的 TCP 连接(本地 socket 仍可用)。开启前必须确认应用、备份、监控客户端都已配好 TLS,否则会被挡在门外。

2. 从库配置 /etc/mysql/mysql.conf.d/mysqld.cnf

[mysqld]
# ---- 身份与网络 ----
server_id                 = 146
bind_address              = 0.0.0.0
port                      = 3306
skip_name_resolve         = ON

# ---- 二进制日志(从库也开,便于故障切换为源)----
log_bin                   = /data/mysql/logs/binlog
log_replica_updates       = ON
binlog_format             = ROW
binlog_row_image          = FULL
binlog_expire_logs_seconds = 604800
sync_binlog               = 1

# ---- GTID ----
gtid_mode                 = ON
enforce_gtid_consistency  = ON

# ---- 只读与崩溃恢复 ----
read_only                 = ON
super_read_only           = ON
relay_log                 = /data/mysql/logs/relaylog
relay_log_recovery        = ON

# ---- 并行复制 ----
replica_parallel_type     = LOGICAL_CLOCK
replica_parallel_workers  = 4
replica_preserve_commit_order = ON

# ---- 持久性 ----
innodb_flush_log_at_trx_commit = 1

# ---- TLS ----
ssl_ca                    = /etc/mysql/ssl/ca.pem
ssl_cert                  = /etc/mysql/ssl/server-146-cert.pem
ssl_key                   = /etc/mysql/ssl/server-146-key.pem
require_secure_transport  = ON

super_read_only=ON 连拥有 SUPER / CONNECTION_ADMIN 的账号也写不进去,比只用 read_only 严格;导入初始数据时需临时关闭(见 A.5)。relay_log_recovery=ON 让实例崩溃后丢弃未应用的 relay log 并依据 GTID 重新拉取,避免位点错乱。

3. 重启并校验参数(两台)

systemctl restart mysql
systemctl status mysql --no-pager | head -5

mysql --defaults-extra-file=/root/.my.cnf -e "
SELECT @@server_id, @@gtid_mode, @@enforce_gtid_consistency,
       @@log_bin, @@binlog_format, @@read_only, @@super_read_only,
       @@relay_log_recovery, @@have_ssl;
SHOW VARIABLES LIKE 'require_secure_transport';"

期望:主库 server_id=145、read_only=OFF;从库 server_id=146、read_only=ON、super_read_only=ON;两台 gtid_mode=ON、log_bin=ON、have_ssl=YES。

4. 主库创建复制账号

-- 主库执行;host 精确到从库 IP,不使用 '10.0.0.%'
CREATE USER IF NOT EXISTS 'repluser'@'10.0.0.146'
  IDENTIFIED BY 'YOUR_PASSWORD' REQUIRE SSL;
GRANT REPLICATION SLAVE ON *.* TO 'repluser'@'10.0.0.146';

SELECT user, host, plugin, ssl_type FROM mysql.user WHERE user = 'repluser';
-- 期望:repluser | 10.0.0.146 | caching_sha2_password | ANY

plugin 应为 caching_sha2_password(8.0 默认)。不要显式指定 mysql_native_password——8.0.34 起已弃用,8.4 更是默认禁用。复制口令会以明文存于从库的 mysql.slave_master_info,因此该账号必须专用、最小权限。

5. 初始数据全量同步(主库有存量数据时必做)

只配复制不会把主库已有数据搬到从库,从库会因「表不存在」中断。若两台都是全新空实例,可跳到下一步。

主库导出(只导业务库,避免覆盖目标实例 mysql 系统库中的账号):

TS=$(date +%F_%H%M)
mysqldump --defaults-extra-file=/root/.my.cnf \
  --databases appdb \
  --single-transaction --routines --triggers --events --hex-blob \
  --default-character-set=utf8mb4 \
  --source-data=2 --set-gtid-purged=ON \
  > /backup/full_${TS}.sql

# 确认 dump 里带有 GTID 集合与位点注释
grep -E "SET @@GLOBAL.GTID_PURGED|SOURCE_LOG_FILE|MASTER_LOG_FILE" /backup/full_${TS}.sql | head -5
scp /backup/full_${TS}.sql root@10.0.0.146:/backup/
  • --source-data=2 把位点写成注释,供时间点恢复参考;GTID 自动定位不依赖它。

  • --set-gtid-purged=ON 让 dump 写入 SET @@GLOBAL.gtid_purged,从库导入后才知道「哪些事务已经包含在快照里」。

  • 需要导出的库多于一个时,在 --databases 后全部列出。

  • 业务账号请在主库用 SHOW CREATE USER 'appuser'@'...' 和 SHOW GRANTS FOR ... 取出,在从库重放;大库或全实例导出建议改用 MySQL Shell 的 util.dumpInstance() / util.loadDump()(自动处理 GTID 与用户),见附录 B。

从库导入(super_read_only 会阻止写入,必须先临时关闭):

-- 从库执行
STOP REPLICA;
RESET REPLICA ALL;
RESET MASTER;              -- 8.0 清空本地 binlog 与 GTID 历史;仅限全新从库!
SET GLOBAL super_read_only = OFF;

RESET MASTER 会删除该实例全部 binlog 并清空 GTID 执行历史。只允许在尚未承载任何业务的全新从库上执行,已有数据的实例执行会造成不可逆的数据/恢复能力损失。

mysql --defaults-extra-file=/root/.my.cnf < /backup/full_${TS}.sql
-- 导入完成后立即恢复只读
SET GLOBAL super_read_only = ON;
SELECT @@GLOBAL.gtid_executed\G      -- 应非空,且与 dump 中的 gtid_purged 一致

6. 配置并启动复制(从库)

STOP REPLICA;
RESET REPLICA ALL;

CHANGE REPLICATION SOURCE TO
  SOURCE_HOST='10.0.0.145',
  SOURCE_PORT=3306,
  SOURCE_USER='repluser',
  SOURCE_PASSWORD='YOUR_PASSWORD',
  SOURCE_AUTO_POSITION=1,
  SOURCE_SSL=1,
  SOURCE_SSL_CA='/etc/mysql/ssl/ca.pem',
  SOURCE_SSL_VERIFY_SERVER_CERT=1,
  SOURCE_CONNECT_RETRY=10,
  SOURCE_RETRY_COUNT=0,
  SOURCE_HEARTBEAT_PERIOD=10;

START REPLICA;
SHOW REPLICA STATUS\G

SOURCE_AUTO_POSITION=1 启用 GTID 自动定位,不再需要手工记 File / Position。启用 TLS 后无需索取公钥参数。

7. 验证要点

SHOW REPLICA STATUS\G
-- Slave_IO_Running: Yes / Slave_SQL_Running: Yes(8.0 输出仍为旧列名)
-- Last_IO_Error、Last_SQL_Error 为空;Auto_Position: 1;Executed_Gtid_Set 非空

-- 主库查看从库是否已连上
SHOW PROCESSLIST;      -- 应存在 Command = 'Binlog Dump' 的行
SHOW MASTER STATUS;    -- 8.0 查位点用这条

四、方案 B:MySQL 8.4.11 LTS

1. 主库配置 /etc/mysql/mysql.conf.d/mysqld.cnf

先备份:cp /etc/mysql/mysql.conf.d/mysqld.cnf{,.bak}。参数含义与 A.1 相同,8.4 中 log_bin 虽默认开启,仍显式指定路径。

[mysqld]
# ---- 身份与网络 ----
server_id                 = 145
bind_address              = 0.0.0.0
port                      = 3306
skip_name_resolve         = ON

# ---- 二进制日志 ----
log_bin                   = /data/mysql/logs/binlog
binlog_format             = ROW
binlog_row_image          = FULL
binlog_expire_logs_seconds = 604800
max_binlog_size           = 1G
sync_binlog               = 1

# ---- GTID ----
gtid_mode                 = ON
enforce_gtid_consistency  = ON

# ---- 持久性 ----
innodb_flush_log_at_trx_commit = 1

# ---- TLS ----
ssl_ca                    = /etc/mysql/ssl/ca.pem
ssl_cert                  = /etc/mysql/ssl/server-145-cert.pem
ssl_key                   = /etc/mysql/ssl/server-145-key.pem
require_secure_transport  = ON

2. 从库配置 /etc/mysql/mysql.conf.d/mysqld.cnf

[mysqld]
# ---- 身份与网络 ----
server_id                 = 146
bind_address              = 0.0.0.0
port                      = 3306
skip_name_resolve         = ON

# ---- 二进制日志 ----
log_bin                   = /data/mysql/logs/binlog
log_replica_updates       = ON
binlog_format             = ROW
binlog_row_image          = FULL
binlog_expire_logs_seconds = 604800
sync_binlog               = 1

# ---- GTID ----
gtid_mode                 = ON
enforce_gtid_consistency  = ON

# ---- 只读与崩溃恢复 ----
read_only                 = ON
super_read_only           = ON
relay_log                 = /data/mysql/logs/relaylog
relay_log_recovery        = ON

# ---- 并行复制 ----
replica_parallel_type     = LOGICAL_CLOCK
replica_parallel_workers  = 4
replica_preserve_commit_order = ON

# ---- 持久性 ----
innodb_flush_log_at_trx_commit = 1

# ---- TLS ----
ssl_ca                    = /etc/mysql/ssl/ca.pem
ssl_cert                  = /etc/mysql/ssl/server-146-cert.pem
ssl_key                   = /etc/mysql/ssl/server-146-key.pem
require_secure_transport  = ON

8.4 中 log_bin 默认开启、binlog_format 默认 ROW、复制元数据仓库固定为 TABLE,以上显式写出是为了可审计、可比对。旧术语复制参数在 8.4 已被全部移除,切勿沿用 8.0.25 之前的写法。

3. 重启并校验参数(两台)

systemctl restart mysql
mysql --defaults-extra-file=/root/.my.cnf -e "
SELECT @@server_id, @@gtid_mode, @@enforce_gtid_consistency,
       @@log_bin, @@binlog_format, @@read_only, @@super_read_only,
       @@relay_log_recovery, @@have_ssl;
SHOW VARIABLES LIKE 'require_secure_transport';"

4. 主库创建复制账号

CREATE USER IF NOT EXISTS 'repluser'@'10.0.0.146'
  IDENTIFIED BY 'YOUR_PASSWORD' REQUIRE SSL;
GRANT REPLICATION SLAVE ON *.* TO 'repluser'@'10.0.0.146';

SELECT user, host, plugin, ssl_type FROM mysql.user WHERE user = 'repluser';
-- 期望:repluser | 10.0.0.146 | caching_sha2_password | ANY

8.4 里权限名仍是 REPLICATION SLAVE;mysql_native_password 默认禁用,显式指定它会报 ERROR 1524 (HY000): Plugin 'mysql_native_password' is not loaded。

5. 初始数据全量同步

主库导出(8.4 的 mysqldump 内部改用 SHOW BINARY LOG STATUS 取位点,命令参数与 8.0 一致):

TS=$(date +%F_%H%M)
mysqldump --defaults-extra-file=/root/.my.cnf \
  --databases appdb \
  --single-transaction --routines --triggers --events --hex-blob \
  --default-character-set=utf8mb4 \
  --source-data=2 --set-gtid-purged=ON \
  > /backup/full_${TS}.sql

grep -E "SET @@GLOBAL.GTID_PURGED|SOURCE_LOG_FILE" /backup/full_${TS}.sql | head -5
scp /backup/full_${TS}.sql root@10.0.0.146:/backup/

从库导入:

STOP REPLICA;
RESET REPLICA ALL;
RESET BINARY LOGS AND GTIDS;   -- 8.4 专用;仅限全新从库!
SET GLOBAL super_read_only = OFF;

RESET BINARY LOGS AND GTIDS 清空全部 binlog 与 GTID 历史,只允许在全新从库执行。

mysql --defaults-extra-file=/root/.my.cnf < /backup/full_${TS}.sql
SET GLOBAL super_read_only = ON;
SELECT @@GLOBAL.gtid_executed\G

6. 配置并启动复制(从库)

STOP REPLICA;
RESET REPLICA ALL;

CHANGE REPLICATION SOURCE TO
  SOURCE_HOST='10.0.0.145',
  SOURCE_PORT=3306,
  SOURCE_USER='repluser',
  SOURCE_PASSWORD='YOUR_PASSWORD',
  SOURCE_AUTO_POSITION=1,
  SOURCE_SSL=1,
  SOURCE_SSL_CA='/etc/mysql/ssl/ca.pem',
  SOURCE_SSL_VERIFY_SERVER_CERT=1,
  SOURCE_CONNECT_RETRY=10,
  SOURCE_RETRY_COUNT=0,
  SOURCE_HEARTBEAT_PERIOD=10;

START REPLICA;
SHOW REPLICA STATUS\G

7. 段验证要点

SHOW REPLICA STATUS\G
-- Replica_IO_Running: Yes / Replica_SQL_Running: Yes(8.4 为新列名)
-- Last_IO_Error、Last_SQL_Error 为空;Auto_Position: 1;Executed_Gtid_Set 非空

SHOW BINARY LOG STATUS;   -- 8.4 查位点用这条
SHOW REPLICAS;            -- 查看已连接的副本

五、验证体系

5.1 部署前检查表

#

检查

命令

期望

1

版本符合锚定

SELECT VERSION();

8.0.46 或 8.4.11

2

server_id 唯一

SELECT @@server_id;

主 145 / 从 146,全拓扑不重复

3

时钟同步

chronyc tracking

偏移 < 1s

4

网络可达

nc -zv 10.0.0.145 3306

succeeded

5

证书有效

openssl verify -CAfile ca.pem server-145-cert.pem

OK,且 SAN 含 10.0.0.145

6

AppArmor 放行

aa-status 查 mysqld 规则

已加载自定义规则

7

凭据文件权限

stat -c %a /root/.my.cnf

600

8

目录属主

stat -c %U /data/mysql/logs

mysql

5.2 配置生效与 TLS 验证

# 两台:确认生产参数确实生效(不要只看配置文件)
mysql --defaults-extra-file=/root/.my.cnf -e "
SELECT @@server_id, @@gtid_mode, @@enforce_gtid_consistency, @@log_bin,
       @@binlog_format, @@sync_binlog, @@binlog_expire_logs_seconds,
       @@read_only, @@super_read_only, @@relay_log_recovery;"

# 从库:确认复制连接确实走了 TLS(用复制账号连主库)
install -m 600 /dev/null /root/.repl.cnf
cat > /root/.repl.cnf <<'EOF'
[client]
user=repluser
password=YOUR_PASSWORD
EOF
chmod 600 /root/.repl.cnf
mysql --defaults-extra-file=/root/.repl.cnf -h 10.0.0.145 -P 3306 \
  --ssl-mode=VERIFY_IDENTITY --ssl-ca=/etc/mysql/ssl/ca.pem \
  -e "SHOW STATUS LIKE 'Ssl_cipher'; SHOW STATUS LIKE 'Ssl_version';"
# 期望:Ssl_cipher 非空(如 TLS_AES_256_GCM_SHA384),Ssl_version = TLSv1.3

5.3 复制状态验证(从库)

SHOW REPLICA STATUS\G

字段(8.0 列名 / 8.4 列名)

期望

不合格含义

Slave_IO_Running / Replica_IO_Running

Yes

网络、账号、TLS、主库不可达

Slave_SQL_Running / Replica_SQL_Running

Yes

应用线程报错(表不存在、主键冲突等)

Last_IO_Error / Last_SQL_Error

空

具体错误见第七章

Auto_Position

1

退回了 file/pos 模式

Executed_Gtid_Set

非空

未启用 GTID 或快照未带 GTID

Seconds_Behind_Master / Seconds_Behind_Source

0 或稳定收敛

持续增大说明追不上

Source_SSL_Allowed

Yes

TLS 未生效

-- GTID 一致性:主库与从库执行,对比集合
SELECT @@GLOBAL.gtid_executed\G
-- 从库还需对比 Retrieved_Gtid_Set 与 Executed_Gtid_Set 的差集,差集持续不收敛 = 应用线程有瓶颈

5.4 数据一致性验证

主库执行:

CREATE DATABASE IF NOT EXISTS repl_verify;
USE repl_verify;
CREATE TABLE IF NOT EXISTS t_sync (
  id INT PRIMARY KEY AUTO_INCREMENT,
  note VARCHAR(64),
  ts TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);
INSERT INTO t_sync (note) VALUES ('repl-check'), ('repl-check-2');
CHECKSUM TABLE repl_verify.t_sync;

从库执行(等 1–2 秒):

SELECT * FROM repl_verify.t_sync;          -- 应看到同样的两行
CHECKSUM TABLE repl_verify.t_sync;         -- Checksum 必须与主库完全一致
SELECT COUNT(*) FROM repl_verify.t_sync;   -- 行数一致

全库级一致性建议定期用 pt-table-checksum(Percona Toolkit)校验;Seconds_Behind_Source 为 0 不等于数据一致。大事务、复制过滤、人为在从库写入都可能造成静默不一致。

5.5 只读与故障演练

-- 从库:普通账号写入应被拒绝(期望 ERROR 1290)
-- 从库:连 root 也应被拒绝(验证 super_read_only 生效)
INSERT INTO repl_verify.t_sync (note) VALUES ('should-fail');
-- 期望:ERROR 1290 (HY000): The MySQL server is running with the --super-read-only option
-- 演练 1:停复制 → 主库写入 → 恢复后自动追平(GTID 的核心价值)
-- 从库
STOP REPLICA;
-- 主库
INSERT INTO repl_verify.t_sync (note) VALUES ('during-stop');
-- 从库
START REPLICA;
SELECT * FROM repl_verify.t_sync WHERE note = 'during-stop';   -- 应出现
SHOW REPLICA STATUS\G                                          -- 追平后延迟归 0

演练 2:从库执行 systemctl restart mysql,再查 SHOW REPLICA STATUS\G,两个线程应恢复为 Yes(MySQL 默认重启后自动恢复复制)。演练前请确认初始同步已完成;若正在重建流程中,先保持 STOP REPLICA。

5.6 从库一键校验脚本

保存为 /root/verify_replication.sh,chmod +x 后执行;退出码 0 = 全部通过,非 0 = 有失败项。脚本自动适配 8.0 / 8.4 的状态字段列名差异。

#!/bin/bash
# 在【从库】本机执行。用法: ./verify_replication.sh
set -u
CNF=/root/.my.cnf
M="mysql --defaults-extra-file=$CNF -N -B -e"
fail=0
ok(){ printf '  PASS  %s\n' "$1"; }
bad(){ printf '  FAIL  %s\n' "$1"; fail=$((fail+1)); }
chk(){ got=$($M "$1" 2>/dev/null | tr -d '\r'); if [ "$got" = "$2" ]; then ok "$3 = $got"; else bad "$3 (期望 '$2', 实际 '$got')"; fi; }
has(){ if [ -n "$($M "$1" 2>/dev/null)" ]; then ok "$2"; else bad "$2"; fi; }

echo "=== 基础参数 ==="
chk "SELECT @@server_id" "146" "server_id"
chk "SELECT @@gtid_mode" "ON" "gtid_mode"
chk "SELECT @@enforce_gtid_consistency" "ON" "enforce_gtid_consistency"
chk "SELECT @@log_bin" "1" "log_bin"
chk "SELECT @@binlog_format" "ROW" "binlog_format"
chk "SELECT @@sync_binlog" "1" "sync_binlog"
chk "SELECT @@read_only" "1" "read_only"
chk "SELECT @@super_read_only" "1" "super_read_only"
chk "SELECT @@relay_log_recovery" "1" "relay_log_recovery"

echo "=== 复制状态 ==="
st=$(mysql --defaults-extra-file="$CNF" -e "SHOW REPLICA STATUS\G" 2>/dev/null)
field(){ printf '%s\n' "$st" | grep -E "^[[:space:]]*$1:" | head -1 | awk -F': ' '{print $2}'; }
io=$(printf '%s\n' "$st" | grep -E '^[[:space:]]*(Replica|Slave)_IO_Running:' | awk -F': ' '{print $2}')
sq=$(printf '%s\n' "$st" | grep -E '^[[:space:]]*(Replica|Slave)_SQL_Running:' | awk -F': ' '{print $2}')
ap=$(field "Auto_Position")
gt=$(field "Executed_Gtid_Set")
ioe=$(field "Last_IO_Error"); sqe=$(field "Last_SQL_Error")
lag=$(printf '%s\n' "$st" | grep -E '^[[:space:]]*Seconds_Behind_(Source|Master):' | awk -F': ' '{print $2}')

[ "$io" = "Yes" ] && ok "IO 线程 = Yes" || bad "IO 线程 = '$io'"
[ "$sq" = "Yes" ] && ok "SQL 线程 = Yes" || bad "SQL 线程 = '$sq'"
[ "$ap" = "1" ] && ok "Auto_Position = 1" || bad "Auto_Position = '$ap'"
[ -n "$gt" ] && ok "Executed_Gtid_Set 非空" || bad "Executed_Gtid_Set 为空"
[ -z "$ioe" ] && ok "Last_IO_Error 为空" || bad "Last_IO_Error: $ioe"
[ -z "$sqe" ] && ok "Last_SQL_Error 为空" || bad "Last_SQL_Error: $sqe"
printf '  INFO  延迟 = %s 秒(应为 0 或持续收敛)\n' "${lag:-NULL}"

echo "=== 数据 ==="
has "SELECT COUNT(*) FROM repl_verify.t_sync" "验证表 repl_verify.t_sync 可查询(请先按 5.4 初始化)"

echo
echo "检查完成:失败 $fail 项(TLS 与数据一致性请另按 5.2 / 5.4 验证)"
exit $((fail > 0))

5.7 持续监控项

指标

来源

告警阈值

复制线程状态

SHOW REPLICA STATUS

任一线程 != Yes,立即告警

复制延迟

Seconds_Behind_Source;大事务场景用 pt-heartbeat

> 30s 持续 5 分钟

错误

Last_IO_Error / Last_SQL_Error

非空即告警

binlog 保留

binlog_expire_logs_seconds

保留期必须 > 从库最长停机时间

从库可写

super_read_only

变为 OFF 即告警

磁盘

/data/mysql/logs 使用率

> 80%

证书有效期

openssl x509 -enddate

剩余 < 30 天


六、运维速查

操作

MySQL 8.0

MySQL 8.4

查看复制状态

SHOW REPLICA STATUS\G(列名仍为旧名)

SHOW REPLICA STATUS\G(新列名)

停止 / 启动

STOP REPLICA; / START REPLICA;

同左

清空复制配置

RESET REPLICA ALL;

同左

查主库位点

SHOW MASTER STATUS;

SHOW BINARY LOG STATUS;

清空 binlog 与 GTID 历史

RESET MASTER;

RESET BINARY LOGS AND GTIDS;

查看已连接副本

SHOW PROCESSLIST;(Binlog Dump)

SHOW REPLICAS;

查看复制连接配置

SELECT * FROM performance_schema.replication_connection_configuration\G

同左

查看应用线程

SELECT * FROM performance_schema.replication_applier_status_by_worker\G

同左

重建从库标准流程:STOP REPLICA → RESET REPLICA ALL → 清空 GTID 历史(按版本选命令,仅全新/可丢弃实例)→ 临时关 super_read_only → 导入新快照 → 开 super_read_only → CHANGE REPLICATION SOURCE TO ... SOURCE_AUTO_POSITION=1 → START REPLICA → 跑 5.6 脚本。

主从切换提示:GTID 下从库可直接 STOP REPLICA; RESET REPLICA ALL; 并关闭只读后提升为源,其余副本 CHANGE REPLICATION SOURCE TO SOURCE_HOST='10.0.0.146', SOURCE_AUTO_POSITION=1 即可自动接续;切换前务必确认原主库已只读/下线,避免双写。


七、故障排查

现象

常见原因

处理

ERROR 1524: Plugin 'mysql_native_password' is not loaded

8.4 默认禁用旧插件

用默认 caching_sha2_password 建账号

Access denied for user 'repluser'

账号 host 不匹配、口令错、TLS 要求不满足

核对 mysql.user 的 host/plugin/ssl_type;用 5.2 的跨机连接命令复现

ERROR 2026 (HY000): SSL connection error

CA 路径错、服务端证书 SAN 不含主库 IP

openssl verify 与 openssl x509 -text 检查 SAN

Got fatal error 1236

主库 binlog 已被 purge,或退回 file/pos 模式

确认 Auto_Position=1;保留期调大;用新快照重建

Could not execute ... table doesn't exist

跳过初始数据同步

按 A.5 / B.5 重新导入快照

ERROR 1290 ... super-read-only

在从库执行了写入或导入

导入前临时 SET GLOBAL super_read_only=OFF,完成后立即恢复

Replica_SQL_Running: No + 主键冲突

从库被人为写入过

不要直接跳过事务;用快照重建

延迟持续增大

单线程回放、大事务、从库 IO 瓶颈

检查 replica_parallel_workers、大事务拆分、从库硬件

CREATE USER 无响应

客户端处于多行输入残留

\c 取消后重输,或用 mysql -e 非交互执行

复制出错时不要用 replica_skip_errors 或跳过事务来「糊过去」,那会制造静默数据不一致;优先用带 GTID 的新快照重建。


八、安全基线检查清单

  • ☐ 口令只存在于 /root/.my.cnf、/root/.repl.cnf(均 600),未写入命令行、脚本变量、全局 profile 文件

  • ☐ repluser host 精确到 10.0.0.146,仅授 REPLICATION SLAVE,REQUIRE SSL

  • ☐ 两台均 require_secure_transport=ON;复制通道 SOURCE_SSL=1 + SOURCE_SSL_VERIFY_SERVER_CERT=1

  • ☐ 不使用未加密连接下索取公钥的参数(仅在隔离内网实验环境临时使用)

  • ☐ 从库 read_only=ON + super_read_only=ON

  • ☐ 防火墙按源 IP 白名单放行 3306,不对全网开放

  • ☐ mysql.slave_master_info 中存有复制口令明文,限制该表的访问并审计

  • ☐ 证书有效期纳入监控;私钥 600、属主 mysql

  • ☐ 分享/上传本文档前,替换或脱敏文中的口令


九、附录

附录 A:官方依据

结论

来源

8.4 移除 MASTER/SLAVE 语句与选项的完整清单

MySQL 8.4.0 Release Notes,dev.mysql.com/doc/relnotes/mysql/8.4/en/news-8-4-0.html

8.0.26 引入 replica_* / source_* 系统变量别名

MySQL 8.0.26 Release Notes

8.4 静态权限仍是 REPLICATION SLAVE

MySQL 8.4 Reference Manual §8.2.2 Privileges Provided by MySQL

8.4 默认禁用 mysql_native_password

MySQL 8.4 Reference Manual §8.4.1.1 Native Pluggable Authentication

mysqldump --source-data / --set-gtid-purged 行为

MySQL 8.0 / 8.4 Reference Manual §6.5.4 mysqldump

8.0 于 2026-04 EOL(8.0.46 最终版)、8.4 LTS 支持周期

MySQL Product Support EOL Announcements;Oracle Lifetime Support Policy

支持低版本源 → 高版本副本,反向不支持

MySQL 8.4 Reference Manual §3.2 Upgrade Paths / §19.5.3

附录 B:大库 / 全实例初始化替代方案

# MySQL Shell(8.0 / 8.4 均支持,并行导出、自动处理 GTID 与用户)
mysqlsh root@localhost --js <<'EOF'
util.dumpInstance("/backup/instance", {threads: 8, consistent: true,
                                       compression: "zstd", users: true})
EOF
# 从库导入(需临时 SET GLOBAL local_infile=ON,导入完成后恢复)
mysqlsh root@localhost --js <<'EOF'
util.loadDump("/backup/instance", {threads: 8, deferTableIndexes: "all"})
EOF

同版本实例也可用 Clone Plugin 快速 Provisioning,它会带上 GTID 状态;但不复制 binlog/relay log 文件,启动复制后仍需主库保留足够的 binlog。物理备份方案(Percona XtraBackup / MySQL Enterprise Backup)适合 TB 级实例。

支持与分享

如果这篇文章对你有帮助,欢迎分享给更多人或者给予支持!

MySQL 8.0 / 8.4 主从复制与验证
/archives/mysql-8.0-8.4
作者
Administrator
发布于
2026-11-17
许可协议
CC BY-NC-SA 4.0