MariaDB 教程 / 理解复制、延迟、错误与故障切换

MariaDB 标准异步复制把主服务器的变更日志传送到副本,再由副本应用这些变更。有副本并不保证数据已经追平,也不自动完成故障切换;应一起管理延迟、错误、可能的数据丢失和应用写入路径。

沿主服务器、接收与应用三个阶段跟踪变更

主服务器把变更写入二进制日志,副本的接收线程把日志取回中继日志,应用线程再将变更写入副本数据。并行复制可能有多个工作线程,但“已经收到”和“已经应用”仍是不同阶段。

主服务器的二进制日志由副本接收为中继日志,再应用到副本数据;接收和应用是不同阶段

主服务器 COMMIT 成功,不表示异步副本已经完成对应事务。写入后立刻从副本查询可能看到旧值;要求写后读一致性的请求,需要明确的读取路由或等待策略。复制还可能传播误删,不能代替独立备份与恢复验证。

GTID 是全局事务标识(Global Transaction ID),用于识别变更组与复制位置。存在 GTID 不等于数据已验证一致,也不意味着任意副本都能提升为主。MariaDB 与 MySQL 的 GTID 实现不同,不能因名称相同就混用语法和行为,参见复制设置指南及MariaDB GTID 文档。

用两个全新空服务器准备首次练习

已有正确配置的独立学习副本时可跳过初始化。下面从Docker Compose 的密码文件与数据卷扩展为双服务器。使用新项目与空卷,不能套到生产服务器或已有副本上。

在新目录创建 secrets/primary-root.txt 和 secrets/replica-root.txt,每个文件一行、保存不同 root 密码,将 secrets/ 排除出版本控制并限制访问。把以下完整配置保存为 compose.yaml。它不发布宿主机端口,两台服务器通过内部 Compose 网络通信。

name: mariadb-replication-lab
services:
  primary:
    image: mariadb:11.8
    environment:
      MARIADB_ROOT_PASSWORD_FILE: /run/secrets/primary_root
    secrets: [primary_root]
    command: ["--server-id=11", "--log-bin=primary-bin", "--binlog-format=ROW", "--gtid-strict-mode=ON"]
    volumes: [primary_data:/var/lib/mysql]
    networks: [replication]
    healthcheck:
      test: ["CMD", "healthcheck.sh", "--connect", "--innodb_initialized"]
      interval: 10s
      retries: 10
      start_period: 30s
  replica:
    image: mariadb:11.8
    environment:
      MARIADB_ROOT_PASSWORD_FILE: /run/secrets/replica_root
    secrets: [replica_root]
    command: ["--server-id=12", "--log-bin=replica-bin", "--binlog-format=ROW", "--gtid-strict-mode=ON", "--read-only=ON"]
    volumes: [replica_data:/var/lib/mysql]
    networks: [replication]
    healthcheck:
      test: ["CMD", "healthcheck.sh", "--connect", "--innodb_initialized"]
      interval: 10s
      retries: 10
      start_period: 30s
secrets:
  primary_root:
    file: ./secrets/primary-root.txt
  replica_root:
    file: ./secrets/replica-root.txt
volumes:
  primary_data:
  replica_data:
networks:
  replication:
    internal: true

在该项目目录终端运行:

docker compose config --quiet
docker compose up -d
docker compose ps

确认两项服务均 healthy 后,在插入应用数据之前配置复制。镜像使用可移动的 11.8 系列标签,需要严格重现时记录批准的补丁或摘要。Compose 配置、镜像启动、网络与卷均需在实际 Docker 环境确认,不能用原生进程的 SQL 试验替代容器启动验证。

打开主服务器的本地管理客户端,在提示处输入其 root 文件密码:

docker compose exec primary mariadb -u root -p

以下代码在主服务器客户端执行,先替换示例复制密码。\q 是客户端退出命令,不是服务器 SQL:

CREATE USER 'repl_lab'@'%' IDENTIFIED BY 'Replace_With_A_Unique_Replication_Password';
GRANT REPLICATION SLAVE ON *.* TO 'repl_lab'@'%';
SHOW GRANTS FOR 'repl_lab'@'%';
\q

百分号来源匹配不代表管理员权限;这里只授予复制能力,且用于无发布端口的专用内部网络。真实远程部署需要限制来源并配置 TLS。授权输出可能含认证信息,不要公开真实密码、命令记录或原始输出。

再打开副本管理客户端:

docker compose exec replica mariadb -u root -p

输入副本 root 密码后,在下列语句填入刚设置的复制密码:

CHANGE MASTER TO
  MASTER_HOST='primary', MASTER_PORT=3306,
  MASTER_USER='repl_lab',
  MASTER_PASSWORD='Replace_With_A_Unique_Replication_Password',
  MASTER_USE_GTID=slave_pos;
START REPLICA;
SHOW REPLICA STATUS\G

初始化假设两台服务器全新、应用数据为空且主服务器日志仍可用。已有数据或缺失日志时,应先建立一致的初始副本和匹配位置;仅设置连接坐标不能修复已有数据差异。确认接收与应用线程都为 Yes,再做后续标记试验。

确认拓扑、服务器身份与诊断权限

复制需要不同 server_id、主服务器二进制日志、专用复制账户、可达路径及一致初始数据。状态查看与控制线程所需权限不同,按版本检查 REPLICA MONITOR 等诊断权限,不要让应用为监控而获得全部管理员能力。

在主服务器运行下面代码,核对身份、二进制日志并记录当前位置:

SELECT @@server_id AS server_id, @@log_bin AS binary_logging,
       @@GLOBAL.gtid_binlog_pos AS logged_gtid;
SHOW MASTER STATUS;

在副本运行下面代码。\G 是 mariadb 客户端的纵向输出结束符,SQL API 不应原样发送它:

SELECT @@server_id AS server_id, @@GLOBAL.read_only AS read_only,
       @@GLOBAL.gtid_slave_pos AS applied_gtid;
SHOW REPLICA STATUS\G

本篇传输、暂停和恢复应用的验证环境是两台临时原生 MariaDB 12.3.3,使用不同编号、ROW 二进制日志与 GTID。该结果说明复制行为,不等于已验证 Compose 11.8 镜像启动、远程证书或生产故障切换。

结合多个状态字段判断接收与应用

字段 解释与限制
Slave_IO_Running 接收线程状态,Yes 不证明已应用到数据
Slave_SQL_Running 应用线程状态,区分人工暂停与错误停止
Last_IO_Error、Last_SQL_Error 区分传输或认证错误与应用错误
Seconds_Behind_Master 延迟指标需结合状态与时间解释,0 或 NULL 均不独立证明健康
Gtid_IO_Pos、gtid_slave_pos 接收位置与应用位置,结合配置域和拓扑判断

即使命令为 SHOW REPLICA STATUS,字段也可能保留旧的 Slave、Master 名称,顺序还会随版本改变。监控程序应按字段名取值,不依赖固定列序号;参见状态命令参考。

线程运行、指定业务写入已经到达、可接受的故障切换丢失窗口,是三个不同检查。应记录状态和位置并核对业务数据或标记。很小的延迟数字也不能排除过滤器、意外副本写入导致的数据分歧。

只在隔离环境暂停应用线程观察差异

此实验需要专用可丢弃复制环境与线程控制权限,不是生产排错时随意暂停副本的操作说明。先在主服务器创建探针,确认同名数据库与表未被其他用途使用:

CREATE DATABASE IF NOT EXISTS replication_lab;
CREATE TABLE replication_lab.probe (
  probe_id INT PRIMARY KEY,
  marker VARCHAR(40) NOT NULL
) ENGINE=InnoDB;
INSERT INTO replication_lab.probe VALUES (1, 'before-pause');

在副本查询,等第一条标记确实到达后再继续:

SELECT probe_id, marker FROM replication_lab.probe ORDER BY probe_id;

仅在副本停止应用线程,接收线程仍可继续取得日志:

STOP REPLICA SQL_THREAD;

然后在主服务器插入第二条标记:

INSERT INTO replication_lab.probe VALUES (2, 'during-pause');

此时副本应仍只有 before-pause 一行。结合状态确认接收线程仍为 Yes、应用线程为 No,接收位置可继续前进,而应用位置保持暂停前状态。这直接展示日志已经收到与查询已能看见数据的差别。

观察后立即在副本恢复应用,再查询:

START REPLICA SQL_THREAD;
SELECT probe_id, marker FROM replication_lab.probe ORDER BY probe_id;

没有冲突过滤或错误时,第二条 during-pause 应到达。复制应用需要时间,一次立即查询未看到不能独立判失败;也不要不查看状态与最后错误就无限等待。核对两条标记与主服务器一致、应用位置追平且线程恢复运行。

不要把恢复命令复制到因其他维护而有意暂停的环境。结束时只在主服务器删除确认可丢弃的探针表,并检查删除已传播到副本,不在两端各自执行不受控修改。

跳过事件或重置位置前,先保留证据

问题 优先检查 避免过早处理
接收线程连不上 地址、端口、DNS、防火墙、TLS、账户及 IO 错误 关闭认证或加密
应用停止 主键重复、缺行、结构差异、过滤器与 SQL 错误 不明数据影响就跳过事件
所需日志已不可用 日志保留、副本位置与初始拷贝一致性 没有匹配数据就强制指定位置
延迟持续增长 写入量、副本 IO、CPU、大事务与锁 只依据一个延迟值提升副本

先保存带时间的状态和错误。已有分歧时,应评估从一致备份重新建立副本。跳过事件可能让线程重新运行,却留下缺失或不一致的数据;误删也可能正常传播,所以复制不是独立恢复手段。

将故障切换视为写入路径的控制

  1. 确认故障并隔离旧主服务器的新写入;网络分区不证明旧主已停止接受写请求。
  2. 检查候选副本的接收、应用位置、积压任务、错误与潜在丢失。
  3. 评估恢复点目标 RPO(recovery point objective,可接受的数据丢失)和恢复时间目标 RTO(recovery time objective,可接受的恢复耗时)。
  4. 按批准的提升与路由流程建立唯一写入目标,并验证应用读写。
  5. 旧主恢复后先检查一致性,必要时重新建立为副本,再接回拓扑。

read_only 限制普通用户写入,却不是阻止所有特权写入的绝对屏障,参见只读副本的权限例外。关闭 read_only 不等于完整提升流程;防止两台服务器同时接受写入的脑裂,需要同时隔离旧主和控制连接路由。