MySQL 8.0 半同步复制需严格匹配版本配置：8.0.26+ 必用 rpl_semi_sync_source 插件与 semisync_source.so，旧版用 rpl_semi_sync_master；wait_point 必设为 AFTER_SYNC 防数据丢失；从库须在 IO 线程启动前装插件、配 relay-log 和 read_only=ON，否则 Rpl_semi_sync_slave_status 永远 OFF；降级不自动恢复，需监控 Rpl_semi_sync_master_no_times 等指标识别真实问题。

MySQL 8.0 的半同步复制不是“开了插件就自动无损”，关键配置错一步，Rpl_semi_sync_master_status 显示 ON 也可能是假象——主库实际仍在异步运行。

主库插件名和 SO 文件必须严格匹配 MySQL 版本

MySQL 8.0.26 是分水岭：旧版用 rpl_semi_sync_master，新版必须用 rpl_semi_sync_source；SO 文件名也从 semisync_master.so 变为 semisync_source.so。混用直接导致插件加载失败或状态始终不生效。

• 查当前版本：SELECT VERSION();
• 8.0.26+ 主库执行：INSTALL PLUGIN rpl_semi_sync_source SONAME 'semisync_source.so';
• ≤8.0.25 主库执行：INSTALL PLUGIN rpl_semi_sync_master SONAME 'semisync_master.so';
• 装完立刻验证：SELECT PLUGIN_NAME, PLUGIN_STATUS FROM INFORMATION_SCHEMA.PLUGINS WHERE PLUGIN_NAME LIKE '%semi%';，状态必须是 ACTIVE
• @@plugin_dir 下必须真实存在对应 SO 文件，Linux 区分大小写，semisync_source.so 写成 semisync_Source.so 就会静默失败

从库 Rpl_semi_sync_slave_status 一直 OFF 的真实原因

这不是插件没装，而是 IO 线程启动时没加载半同步逻辑——SET GLOBAL rpl_semi_sync_slave_enabled = 1 不触发重载，只改变量值。

MySQL8 CRM Schema Design Expert

面向 CRM 系统的 MySQL 8 数据库模式设计。当用户需要为客户关系管理（CRM）系统设计、评审、优化或生成数据库模式时，应使用此项技能。

下载

• 必须显式重启 IO 线程：STOP SLAVE IO_THREAD; START SLAVE IO_THREAD;
• 从库 my.cnf 中必须提前配好 relay-log = relay-bin（不能依赖默认值），否则插件拒绝激活
• read_only = ON 是硬性前提，不设则 Rpl_semi_sync_slave_status 永远为 OFF
• 如果主从已用 GTID 运行多日，再临时装插件、SET 变量，IO 线程早已建连完成，半同步握手阶段已错过，必须重启线程才能补上

rpl_semi_sync_source_wait_point 必须设为 AFTER_SYNC

这个变量决定“主库崩溃时，已返回客户端的事务是否一定存在于从库”。设错等于白配。

• AFTER_SYNC（推荐）：主库写完 binlog → 等 ACK → 再提交 → 崩溃后，所有已返回成功的事务都已在至少一个从库 relay log 中
• AFTER_COMMIT（危险）：主库先提交 → 再等 ACK → 崩溃时，已返回客户端但未发出去的事务彻底丢失
• 主库执行：SET GLOBAL rpl_semi_sync_source_wait_point = 'AFTER_SYNC';（8.0.26+）或 SET GLOBAL rpl_semi_sync_master_wait_point = 'AFTER_SYNC';（旧版）
• 该设置对后续事务生效，不影响正在执行的事务

超时降级不会自动恢复，靠监控指标识别真问题

只看 Rpl_semi_sync_master_status = ON 容易误判。真正要盯的是降级次数和是否触发过 fallback。

• 查状态：SHOW STATUS LIKE 'Rpl_semi_sync%';
• Rpl_semi_sync_master_no_times：累计降级次数，非零说明出过问题
• Rpl_semi_sync_master_off_times：因超时主动关闭的次数，持续增长说明网络或从库 IO 压力大
• rpl_semi_sync_source_timeout（或旧版 rpl_semi_sync_master_timeout）建议设为 3000（3 秒），太短易误降级，太长阻塞业务
• 降级后不会自动恢复，需下一个事务触发重试，或手动重启 IO 线程

最容易被忽略的是：从库必须在 IO 线程第一次启动前就装好插件并启用 rpl_semi_sync_replica_enabled（或旧版 rpl_semi_sync_slave_enabled）。一旦复制通道建立完成，再补插件，半同步握手就永远错过了。