MySQL 8.0 / 8.4 主从复制与验证

一、版本选型
1.1 版本状态(截至 2026-11)
8.0 版本必须 ≥ 8.0.26,因为本文两版统一使用 8.0.26 引入的
replica_*/source_*术语;若你的 8.0 更早,需把log_replica_updates、replica_parallel_workers、replica_preserve_commit_order换回对应的旧术语参数。
1.2 环境规划(两套方案共用)
数据目录:
/var/lib/mysql(保持默认);binlog / relaylog:/data/mysql/logs;备份:/backup;证书:/etc/mysql/sslroot 口令:
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 的关键差异
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 部署前检查表
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
-- 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 持续监控项
六、运维速查
重建从库标准流程: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 即可自动接续;切换前务必确认原主库已只读/下线,避免双写。
七、故障排查
复制出错时不要用
replica_skip_errors或跳过事务来「糊过去」,那会制造静默数据不一致;优先用带 GTID 的新快照重建。
八、安全基线检查清单
☐ 口令只存在于
/root/.my.cnf、/root/.repl.cnf(均 600),未写入命令行、脚本变量、全局 profile 文件☐
repluserhost 精确到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:官方依据
附录 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 级实例。
