MySQL主从迁移核心是平滑转移主库角色并更新复制关系。需先验证数据一致性和复制状态，再停写导出数据，最后重配新主库及从库指向。
MySQL主从复制环境下迁移主库，核心是把原主库的角色平滑转移到新服务器，同时确保从库能继续同步、业务不中断。关键不是简单换IP，而是重新组织复制关系并更新所有节点的配置。
一、提前准备：确认当前复制状态与数据一致性
迁移前必须确保主从数据一致，且复制无延迟：
- 在原主库执行 SHOW MASTER STATUS;，记下 File 和 Position
- 在每个从库执行 SHOW SLAVE STATUS\G;，检查 Seconds_Behind_Master = 0、Slave_IO_Running 和 Slave_SQL_Running 都为 Yes
- 若存在延迟，先等同步完成；如有错误，需先修复复制中断问题
二、停写并导出原主库数据（可选物理/逻辑方式）
根据数据量和停机窗口选择方式：
- 小数据量（：用 mysqldump 导出全库，加上 --single-transaction --master-data=2，自动记录位点
-
大数据量或需最小停机：使用 Percona XtraBackup 做热备份，备份完成后执行 xtrabackup --prepare 并拷贝到新主库
- 无论哪种方式，导出/恢复前后都要校验表数量、行数（如 SELECT COUNT(*) 抽样）和关键业务数据
三、在新服务器上搭建新主库并启用写入
新服务器初始化后需配置为可写主库，并开放复制权限：
- 修改 my.cnf：设置 server-id（唯一且不同于所有从库）、开启 log-bin、配置 binlog_format = ROW
- 启动 MySQL，导入之前备份的数据（若用 xtrabackup，注意恢复后 chown 权限并重启）
- 创建用于从库连接的复制用户：
CREATE USER 'repl'@'%' IDENTIFIED BY 'your_pass';
GRANT REPLICATION SLAVE
ON *.* TO 'repl'@'%';
FLUSH PRIVILEGES;
四、重置从库指向新主库
所有从库需停止复制、切换主库地址和位点：
- 在每个从库执行：
STOP SLAVE;
CHANGE MASTER TO
MASTER_HOST='新主库IP',
MASTER_PORT=3306,
MASTER_USER='repl',
MASTER_PASSWORD='your_pass',
MASTER_LOG_FILE='mysql-bin.000001',
MASTER_LOG_POS=154;
START SLAVE;
- 位点（MASTER_LOG_FILE / MASTER_LOG_POS）来自新主库的 SHOW MASTER STATUS;（不是原主库的！）
- 执行后立即检查 SHOW SLAVE STATUS\G;，确认无报错且同步正常
五、切换应用连接与收尾验证
应用层必须指向新主库，之后持续观察：
- 将应用配置中的数据库写地址从旧主库 IP 改为新主库 IP（建议通过 DNS 或负载均衡器统一管理，便于后续调整）
- 在新主库写入测试数据（如插入一条带时间戳的记录），然后查所有从库是否及时出现
- 监控新主库的 Threads_connected、Queries 及慢日志，确认写入流量已承接
- 旧主库可改为只读备用，或按需下线；记得关闭其 log-bin 避免误写产生无效 binlog
整个过程不复杂但容易忽略细节，重点在于位点对齐、权限开通和应用配置同步。只要每步验证到位，主库迁移可以做到业务几乎无感。
ON *.* TO 'repl'@'%';