Docker Compose是构建MySQL主从集群最稳妥可复现的方式,需创建专用自定义网络(如mysql-repl-net)、统一binlog配置(路径与格式)、显式设置server-id、用mysql_native_password创建复制用户,并严格按序执行SHOW MASTER STATUS和CHANGE MASTER TO确保时序正确。

docker compose 是当前最稳妥、可复现的主从集群构建方式。硬编码 docker run 命令容易漏掉网络隔离、启动顺序、配置加载时机等关键点,直接导致从库连不上主库或复制中断。
必须创建专用 Docker 网络
默认 bridge 网络下容器间 DNS 解析不可靠,mysql-slave 容器无法稳定解析 mysql-master 主机名。
- 执行
docker network create mysql-repl-net创建自定义网络 - 所有服务必须显式声明
networks: [mysql-repl-net] - 不要用
--link(已废弃)或host.docker.internal(Windows/macOS 专用,Linux 不生效)
server-id 和 binlog 配置不能只改数字
server-id 冲突或 log-bin 路径不一致是主从同步失败的头号原因。MySQL 8.0 默认禁用 log-bin,且要求 server-id 必须为非零整数 —— 但更关键的是:主从必须使用**完全相同的 binlog 格式与基础路径名**。
- 主配置中写
log-bin = mysql-bin,从配置里也得写一模一样的值,不能写成log-bin = slave-bin -
server-id主库设1,从库设2即可,但必须保证整个集群内全局唯一(多从库时不能都设2) - 务必在
[mysqld]段落下设置binlog_format = ROW,语句级(STATEMENT)在 8.0 下可能因函数/临时表触发复制错误
从库启动后必须手动执行 CHANGE MASTER TO
Docker 启动容器 ≠ MySQL 服务就绪。主库没完全初始化完,从库就急着连,会报错 ERROR 2003 (HY000): Can't connect to MySQL server 或 ERROR 2013 (HY000)。这不是配置问题,是时序问题。
- 先等主库输出
MySQL init process done. Ready for start up.日志(可用docker logs -f mysql-master观察) - 进主库执行:
SHOW MASTER STATUS;记下File和Position - 进从库执行:
CHANGE MASTER TO MASTER_HOST='mysql-master', MASTER_USER='repl', MASTER_PASSWORD='repl123', MASTER_LOG_FILE='mysql-bin.000001', MASTER_LOG_POS=156;—— 注意主机名必须是 compose 服务名,不是localhost - 再执行
START SLAVE;,然后SHOW SLAVE STATUS\G查看Seconds_Behind_Master是否为0且无IO_Running/SQL_Running报错
root 密码和复制用户权限要分清
很多人误以为只要主库 MYSQL_ROOT_PASSWORD 一致就能自动复制,其实不然。MySQL 8.0 默认认证插件是 caching_sha2_password,而复制用户必须用 mysql_native_password 才能被旧版客户端(包括部分从库连接逻辑)兼容。
- 主库启动后,进容器执行:
CREATE USER 'repl'@'%' IDENTIFIED WITH mysql_native_password BY 'repl123'; - 再执行:
GRANT REPLICATION SLAVE ON *.* TO 'repl'@'%'; FLUSH PRIVILEGES; - 别用
root用户做复制 —— 权限过大,且caching_sha2_password在某些 Docker 网络场景下握手失败率高
真正卡住人的,从来不是配置项写错,而是主从容器启动不同步、复制用户认证方式不匹配、或者 CHANGE MASTER TO 用的 binlog 文件名/位置已经过期。这些细节不会报“配置错误”,只会静默失败或延迟几秒后断连。











