主从复制需手动配置server-id和log-bin并重启mysql生效，主从server-id必须不同且非0，log-bin必须开启；change master to须用show master status实时获取的file和position；复制用户需显式授予replication slave权限并flush privileges。
主从复制不是“点一下就通”，server-id 和 log-bin 必须手动配对生效
宝塔面板本身不提供主从复制的图形化开关，所有核心配置都得改 MySQL 的 my.cnf（或宝塔里「MySQL 设置 → 配置修改」中编辑的配置文件）。很多人卡在第一步：改完配置没重启 MySQL，或者重启了但没检查是否真正加载成功。
关键点有三个：
-
server-id在主、从服务器上必须不同（比如主设为1，从设为2），且不能为0； -
log-bin必须开启（如log-bin=mysql-bin），否则主库无法生成 binlog，从库无日志可同步； - 宝塔默认配置文件路径是
/www/server/mysql/etc/my.cnf，修改后一定要执行systemctl restart mysqld或在宝塔「软件商店 → MySQL → 重启」。
验证是否生效：登录 MySQL 后执行 show variables like 'server_id'; 和 show variables like 'log_bin';，两个返回值都应为非空且符合预期。
从库执行 CHANGE MASTER TO 前，必须先拿到主库的 File 和 Position
这是最容易出错的环节。很多教程直接贴出 CHANGE MASTER TO ... master_log_file='mysql-bin.000012', master_log_pos=6574697;，但这个 File 和 Position 是动态的，每次主库重启、flush logs、甚至某些 DDL 操作都会变。
正确流程是：
- 在主库执行
show master status;，记录当前输出的File（如mysql-bin.000015）和Position（如154）； - 从库执行
CHANGE MASTER TO时，必须用这组实时值，不能抄旧截图； - 如果主库已有数据，建议先锁表导出（
FLUSH TABLES WITH READ LOCK;），再导出 + 记录位置，最后解锁（UNLOCK TABLES;），避免同步起点错位。
漏掉这一步，start slave; 后 Slave_IO_Running 可能为 No，查 show slave status\G 会看到 Got fatal error 1236 或连接超时类错误。
复制用户权限不够会导致 Slave_IO_Running: No，REPLICATION SLAVE 是底线
宝塔里用 phpMyAdmin 新建用户时，很多人只勾选了 SELECT、INSERT 等常规权限，却忘了最关键的复制权限。从库 IO 线程连不上主库，90% 是因为这个。
主库上必须显式授权：
CREATE USER 'repl'@'从库IP' IDENTIFIED BY 'strong_password'; GRANT REPLICATION SLAVE ON *.* TO 'repl'@'从库IP';
注意两点：
- 用户名后
@'从库IP'必须写准确（如@'192.168.1.101'），不能写成@'%'（除非你明确允许任意 IP 连接，存在安全风险）； - 仅
REPLICATION SLAVE就够了，不需要FILE或SELECT—— 这些是旧版全量同步才需要的，纯 binlog 复制不需要； - 授权后务必执行
FLUSH PRIVILEGES;，否则权限不生效。
双机热备 ≠ 主主复制，auto_increment_offset 和 increment 不配好就会主键冲突
如果你真要双向同步（A 写 B 也写），就不能只做单向主从。主主结构下，两边同时插入自增主键，不加控制必然冲突。宝塔里常见错误是只配了 server-id 和 log-bin，却漏掉这两项：
-
auto_increment_increment = 2：步长设为节点数（双节点就是 2）； -
auto_increment_offset = 1（主 A）和= 2（主 B）：起始偏移错开；
这样 A 插入主键为 1、3、5…，B 插入为 2、4、6…，避免冲突。但要注意：replicate-do-db 要明确指定库名，且两台机器的配置除 server-id 和 auto_increment_offset 外，其余必须一致；否则容易出现一边同步、另一边不触发的情况。
真正上线前，务必在测试库用并发插入压测几分钟，再查两边主键是否重叠——这点常被跳过，等上线写进生产数据才发现删都删不干净。
