配置MySQL半同步复制需先安装插件并启用，主库等待从库确认接收binlog后提交事务。1. 确保MySQL版本≥5.7且主从异步复制正常；2. 主从分别安装rpl_semi_sync_master/slave插件；3. 配置my.cnf开启半同步并设超时时间；4. 从库重启I/O线程；5. 查看Rpl_semi_sync_master_status为ON表示成功；6. 注意超时退化机制与数据安全参数配合使用，确保高可用与一致性。
MySQL 配置半同步复制可以提升主从数据一致性，避免主库宕机时出现数据丢失。要实现半同步复制，需要在主从架构中启用 semi-sync replication 插件，并确保主库等待至少一个从库确认接收到事务日志（binlog）后才提交事务。
1. 确认环境要求
半同步复制依赖插件，需满足以下条件：
- MySQL 版本 >= 5.7（推荐 8.0+）
- 主从之间已配置好异步复制（基于 binlog 的主从同步）
- 主从服务器时间同步、网络稳定
2. 安装半同步插件
分别在主库和从库上安装对应的插件。
在主库执行：INSTALL PLUGIN rpl_semi_sync_master SONAME 'semisync_master.so';
在从库执行：
INSTALL PLUGIN rpl_semi_sync_slave SONAME 'semisync_slave.so';
可通过以下语句验证插件是否安装成功：
SHOW PLUGINS LIKE '%semi%';
3. 启用半同步配置
修改主从的 my.cnf 配置文件，添加相关参数。
主库 my.cnf 配置：
[mysqld] rpl_semi_sync_master_enabled = 1 rpl_semi_sync_master_timeout = 10000 # 超时时间，单位毫秒（10秒），超时后退化为异步
从库 my.cnf 配置：
[mysqld] rpl_semi_sync_slave_enabled = 1
修改后重启 MySQL 服务或动态生效（部分参数可动态设置）。
4. 重启从库 I/O 线程
从库启用 semi-sync 插件后，需重启 I/O 线程才能生效：
STOP SLAVE IO_THREAD; START SLAVE IO_THREAD;
5. 验证半同步状态
检查主从是否成功建立半同步连接。
在主库查看状态：
SHOW STATUS LIKE 'Rpl_semi_sync_master_status'; SHOW STATUS LIKE 'Rpl_semi_sync_master_clients';
- Rpl_semi_sync_master_status 为 ON 表示半同步已启用并运行
- Rpl_semi_sync_master_clients 显示当前连接的半同步从库数量
查看半同步相关变量：
SHOW VARIABLES LIKE 'rpl_semi_sync%';
6. 注意事项与常见问题
- 如果从库断开或延迟大，主库会等待超时后自动切换为异步模式，保障可用性
- 超时时间设置要合理，太短可能频繁退化，太长影响性能
- 建议配合使用 sync_binlog=1 和 innodb_flush_log_at_trx_commit=1 提高数据安全性
- 监控 Rpl_semi_sync_master_no_times 和 Rpl_semi_sync_master_no_tx 判断退化频率
基本上就这些。配置完成后，主库每次提交事务都会等待至少一个从库返回 ACK，从而实现更强的数据保护。
