排查 MySQL 异步复制故障转移时,先看“候选源清单”比直接猜当前连接更可靠。要查看某个复制通道准备了哪些备用源,可以查询 Performance Schema 的 replication_asynchronous_connection_failover 表;它记录通道、主机、端口、网络命名空间、权重以及托管组标识。注意:表里有候选源,只代表配置清单存在,不代表自动切换前提已经全部满足。
官方地址:https://dev.mysql.com/doc/refman/8.4/en/replication-asynchronous-connection-failover.html
最小判断路径是:先按CHANNEL_NAME读候选源,再解释WEIGHT,最后把查询结果与 GTID 自动定位、SOURCE_CONNECTION_AUTO_FAILOVER和重试参数对照。
先确定候选源表与复制通道
replication_asynchronous_connection_failover 是候选源清单,不是当前复制线程状态表。它的每一行表示:当某个通道与当前 source 的连接失败后,这个地址可以作为替代 source。先把通道名称和表结构列出来,避免把空结果误认为“没有复制”。
-- 先确认当前实例可见的候选源表和复制通道。 SHOW COLUMNS FROM performance_schema.replication_asynchronous_connection_failover; -- 只读取候选源清单,不把当前连接状态混进来。 SELECT CHANNEL_NAME, HOST, PORT, NETWORK_NAMESPACE, WEIGHT, MANAGED_NAME FROM performance_schema.replication_asynchronous_connection_failover ORDER BY CHANNEL_NAME, WEIGHT DESC, HOST, PORT;
如果环境使用的是默认通道,CHANNEL_NAME 通常为空字符串;多源复制或业务隔离场景则应明确使用实际通道名。查询结果只表示该实例本地看到的清单,不能替代对复制连接状态的单独检查。
按复制通道读取候选源清单
生产排查时建议先过滤通道,再保留能够帮助值班人员做决定的字段。HOST 和 PORT 定位候选源,NETWORK_NAMESPACE 表示网络命名空间;空值或空字符串意味着使用默认命名空间。WEIGHT 是 1 到 100 的优先级,数值越大越先尝试。
-- 用明确的通道名缩小排查范围,避免误读其他通道。
SET @channel_name = 'orders_channel';
SELECT
CHANNEL_NAME,
HOST,
PORT,
NETWORK_NAMESPACE,
WEIGHT,
MANAGED_NAME
FROM performance_schema.replication_asynchronous_connection_failover
WHERE CHANNEL_NAME = @channel_name
ORDER BY WEIGHT DESC, HOST, PORT;
-- 这条结果是配置清单,不是某个 source 已经可连接的证明。
同一权重的候选源不应被当成固定顺序;官方说明允许同权 source 以随机顺序尝试。若最高权重的 source 不可用,机制会继续按权重从高到低尝试清单中的其他 source,再从高权重处重新开始。
解释权重和托管组字段
MANAGED_NAME 不等于普通主机名,它用于标识由托管机制维护的组;例如 Group Replication 场景会根据组成员变化更新候选源。手工加入的独立 source 可以没有托管组标识。查看时不要只数行数,还要问三个问题:这个通道是否有候选源、最高权重是否符合预期、这些行是独立 source 还是托管组成员。
| 字段 | 含义 | 排查重点 |
|---|---|---|
| CHANNEL_NAME | 复制通道 | 先按通道隔离查询 |
| HOST / PORT | 候选 source 地址 | 确认地址属于目标复制拓扑 |
| WEIGHT | 1–100 的优先级 | 高权重先尝试,同权顺序不固定 |
| MANAGED_NAME | 托管组标识 | 区分 Group Replication 动态成员与独立 source |
如果只想看托管组相关记录,可以保留 MANAGED_NAME 非空的行;但不要据此断言组成员当前在线。候选清单和组成员在线状态是两个不同观察面。
把清单与自动故障转移开关对照
查看到候选源后,下一步是确认控制条件。MySQL 8.4 文档要求异步连接故障转移使用 GTID,并在通道上启用 SOURCE_AUTO_POSITION=1;自动故障转移开关是 SOURCE_CONNECTION_AUTO_FAILOVER=1。如果只配置了表中的候选源,却没有打开通道开关,清单仍然能读到,但不会按预期接管。
-- 读取通道连接配置,核对自动定位与自动故障转移开关。
SELECT
CHANNEL_NAME,
HOST,
PORT,
SOURCE_AUTO_POSITION,
SOURCE_CONNECTION_AUTO_FAILOVER,
SOURCE_RETRY_COUNT,
SOURCE_CONNECT_RETRY
FROM performance_schema.replication_connection_configuration
WHERE CHANNEL_NAME = 'orders_channel';
-- 这里只做配置对照,不在排查查询中修改复制参数。
还要留意重试参数:自动故障转移会在针对原 source 的重试耗尽后接管;如果 SOURCE_RETRY_COUNT 与 SOURCE_CONNECT_RETRY 仍然很大,观察到“迟迟没有尝试备用源”并不一定是候选清单失效。
按风险边界处理空结果和权限
空结果至少有三种解释:该通道没有配置候选 source、查询过滤的通道名不对,或当前账号没有读取 Performance Schema 所需权限。异步故障转移还要求复制账号能够读取相关 Performance Schema 表;因此排查时应记录查询账号、通道名和查询时间,不要把权限问题写成“没有备用源”。
Group Replication 场景下,候选源清单会随成员加入、离开或清单更新而广播;托管组记录也可能由机制自动维护。单独的 replica 如果不属于复制组,不能使用面向副本组的那部分故障转移能力。看到 MANAGED_NAME 后,还要回到拓扑边界确认当前节点是否属于允许的组。
常见问题
查询到候选源后就能证明故障转移已开启吗?
不能。还需检查通道的 SOURCE_CONNECTION_AUTO_FAILOVER、GTID 自动定位和重试参数;候选源表只是输入清单。
WEIGHT 越大是否代表 source 一定在线?
不是。它只决定优先级。实际连接还要受到 source 可达性、Group Replication 成员状态和复制账号配置影响。
为什么同一个通道会有多行相同主机?
应连同端口、网络命名空间和托管组字段一起看;不同通道或不同管理关系都可能形成不同记录,不能只按 HOST 去重。
小结
查看 MySQL 异步复制故障转移候选源,核心是查询 performance_schema.replication_asynchronous_connection_failover,按 CHANNEL_NAME 过滤,再用 WEIGHT 判断优先级、用 MANAGED_NAME 判断托管关系。最后把清单与 GTID 自动定位、SOURCE_CONNECTION_AUTO_FAILOVER、重试参数和账号权限放在同一张排查表里,才能区分“没有候选源”和“有候选源但控制条件不完整”。

Go debug/macho.DylibCmd 怎样解释动态库加载头中的版本字段
