必须挂载到 /etc/mysql/conf.d/ 才生效,官方 mysql:8.0 镜像不读 /etc/mysql/my.cnf;需以 .cnf 结尾、含 [mysqld] 段,且必须包含 skip-host-cache 和 skip-name-resolve,字符集与认证插件需配套设置为 utf8mb4 和 mysql_native_password,修改后须 docker restart。

挂载到 /etc/mysql/conf.d/ 才生效,不是 /etc/mysql/my.cnf
官方 mysql:8.0 镜像压根不读 /etc/mysql/my.cnf,哪怕你用 -v ./my.cnf:/etc/mysql/my.cnf 挂载,也完全无效。它只自动加载 /etc/mysql/conf.d/ 和 /etc/mysql/mysql.conf.d/ 下所有以 .cnf 结尾的文件。
正确做法是:
- 把配置文件(比如叫
mysqld.cnf)放在宿主机任意目录,例如./conf/mysqld.cnf - 用
-v ./conf/mysqld.cnf:/etc/mysql/conf.d/mysqld.cnf:ro挂载(:ro防止容器内误改) - 确认文件内容以
[mysqld]开头,且无中文标点、行首空格、漏括号等语法错误
skip-host-cache 和 skip-name-resolve 必须加
不加这两项,容器启动会卡在 DNS 解析阶段:日志反复出现 getaddrinfo failed,或长时间无输出后超时退出。这不是“可能出问题”,而是大概率直接起不来。
它们的作用是跳过反向 DNS 查询,跟网络模式无关——哪怕你用 --network host 或固定 IP,也建议保留。
[mysqld] 段开头就写这两行,顺序无关,但必须存在:
[mysqld] skip-host-cache skip-name-resolve character-set-server = utf8mb4 default-authentication-plugin = mysql_native_password
字符集和认证插件必须配套设
只写 character-set-server = utf8mb4 不够。MySQL 8.0 默认用 caching_sha2_password 插件,但 Navicat ≤ 12、SQLyog、老版 JDBC 驱动都不支持,会报错:Authentication plugin 'caching_sha2_password' cannot be loaded。
所以必须同步设 default-authentication-plugin = mysql_native_password。
如果数据目录 /var/lib/mysql 已非空(即不是首次初始化),仅改配置不生效,还需进容器执行:
ALTER USER 'root'@'%' IDENTIFIED WITH mysql_native_password BY 'your_password';
验证是否生效:
docker exec -it <container_name> mysql -uroot -p$MYSQL_ROOT_PASSWORD -e "SELECT plugin FROM mysql.user WHERE user='root';"</container_name>
改完必须 docker restart,不能 reload
容器内 MySQL 不支持 mysqladmin reload 或 SIGHUP 动态重载。你在容器里 vim /etc/mysql/conf.d/mysqld.cnf、service mysql restart、甚至 kill -HUP 进程,全都没用。
唯一可靠方式就是 docker restart 。注意:重启不会清空数据,但新配置会在 mysqld 启动时加载。
容易被忽略的一点是:如果你之前没挂载配置目录,现在临时想改,别在容器里折腾 apt install vim 或手动复制文件——那只是临时修改,下次重启就丢。停容器、加 -v 重新跑,才是 Docker 场景下的正解。











