server-id必须全局唯一且非零、binlog_format=ROW是MySQL 8.0主从复制运行的底线要求；主库需显式配置log-bin、正确创建mysql_native_password认证的复制用户，并确保容器网络互通。
server-id 必须全局唯一，binlog_format=ROW 是底线要求，否则复制大概率中断或数据不一致——这不是可选项，是MySQL 8.0主从能跑通的最小前提。
主库容器启动前必须确认的三项配置
主库不是“能连上就行”，它得主动产生可被正确解析的变更日志。很多失败卡在第一步，就因为容器一启动，SHOW MASTER STATUS 返回空或报错。
-
server-id设为非零整数（如1），且不能和任何从库重复；Docker Compose里用environment覆盖无效，必须写进挂载的/etc/my.cnf或/etc/mysql/conf.d/下的 .cnf 文件 -
log-bin必须显式开启（如log-bin = mysql-bin），路径无需指定全路径，MySQL会自动放在datadir下；若只写log_bin（下划线）在某些镜像版本中会被忽略 -
binlog-format必须设为ROW，不能是STATEMENT或MIXED；MySQL 8.0 默认仍是STATEMENT，不改就会在从库遇到函数、临时表、非确定性SQL时直接中断复制
从库连不上主库？先查这三件事
从库报 ERROR 2003 (HY000): Can't connect to MySQL server 或 Authentication plugin 'caching_sha2_password' cannot be loaded，90% 是网络或认证问题，不是配置文件漏写了。
- 主库容器必须暴露端口并加入同一自定义网络：用
docker network create mysql-net创建网络，两个容器都通过networks: - mysql-net加入，别依赖默认bridge；从库连接主库时用容器名（如mysql-master）当 host，不是localhost或宿主机 IP - 主库必须创建兼容的复制用户：
CREATE USER 'repl'@'%' IDENTIFIED WITH mysql_native_password BY 'repl123';+GRANT REPLICATION SLAVE ON *.* TO 'repl'@'%';；MySQL 8.0 默认用caching_sha2_password插件，从库客户端不支持，不切回mysql_native_password就连不上 -
CHANGE REPLICATION SOURCE TO的参数顺序和大小写要严格匹配：MASTER_HOST是容器名或 Docker 网络内可达 IP，MASTER_PORT是容器内端口（始终是3306），不是宿主机映射端口；MASTER_LOG_FILE和MASTER_LOG_POS必须来自主库执行SHOW MASTER STATUS的实时输出，不能抄文档示例值
START REPLICA 后状态卡在 Connecting 或 Not Running
看到 Slave_IO_Running: Connecting 或 SQL_Running: No，说明链路没真正打通。不要急着重启容器，先看关键字段。
- 运行
SHOW REPLICA STATUS\G，重点盯Seconds_Behind_Master、Retrieved_Gtid_Set、Executed_Gtid_Set；如果前者为NULL，后者为空，说明 IO 线程根本没拉到任何日志，问题出在网络或用户权限 - 检查
Last_IO_Error字段，常见值如Access denied for user 'repl'@'172.18.0.3'（用户没授权该IP）、Could not find first log file name in binary log index file（主库没开 binlog 或配置没生效） - 从库配置里不要加
log-bin，除非它还要做级联从库；加了反而可能触发 GTID 冲突，尤其当主库也开了 GTID 时；MySQL 8.0 默认已启用 GTID，enforce-gtid-consistency=ON和gtid-mode=ON应该已在镜像默认配置中，不必手动加
验证同步是否真实有效，别只看 “Yes”
IO_Running: Yes 和 SQL_Running: Yes 只代表线程活着，不代表数据真同步了。线上出过太多“看着正常、查不到新数据”的案例。
- 主库执行：
CREATE TABLE test_sync (id INT PRIMARY KEY, ts TIMESTAMP DEFAULT CURRENT_TIMESTAMP); INSERT INTO test_sync VALUES (1, NOW()); - 立刻在从库查：
SELECT * FROM test_sync;—— 必须返回结果，且ts值与主库一致；延迟超过 1 秒就要查Seconds_Behind_Master - 删掉主库某条记录后，从库对应行必须消失；UPDATE 同理。只建表插入还不够，得覆盖增删改全路径
- 别用
SELECT SLEEP(1)等待，用SHOW REPLICA STATUS实时看Seconds_Behind_Master归零再验证；有些镜像启动慢，docker-compose up -d后等 10 秒再连库操作
真正的难点不在命令怎么写，而在于每个容器的 server-id、网络命名空间、用户认证机制、binlog 格式这四者必须对齐。差其中任意一个，复制就变成“看起来在跑，其实没动”。
