必须挂载到 /etc/mysql/conf.d/ 而非 /etc/mysql/my.cnf，因为MySQL官方镜像按 /etc/mysql/my.cnf → /etc/mysql/conf.d/*.cnf → /etc/mysql/mysql.conf.d/*.cnf 顺序加载配置，conf.d 目录专为用户自定义设计，权限友好、优先级合理、支持叠加覆盖且不破坏镜像内置安全初始化逻辑。
直接挂载 my.cnf 到 /etc/mysql/conf.d/ 是最稳妥的方式，能覆盖镜像默认配置，且无需修改容器内文件系统。
为什么必须挂载到 /etc/mysql/conf.d/ 而不是 /etc/mysql/my.cnf
MySQL 官方镜像（mysql:8.0 等）启动时读取配置的顺序是：/etc/mysql/my.cnf → /etc/mysql/conf.d/*.cnf → /etc/mysql/mysql.conf.d/*.cnf。其中 /etc/mysql/conf.d/ 目录下所有 .cnf 文件按字母序加载，且后加载的会覆盖先加载的同名参数。
镜像自带的主配置通常在 /etc/mysql/my.cnf，但该文件不可写、不建议覆盖；而 /etc/mysql/conf.d/ 是专为用户自定义配置设计的挂载点，权限友好、优先级合理、重启即生效。
- 挂载
/etc/mysql/my.cnf会完全替换主配置，可能丢失镜像内置的安全初始化逻辑（如 socket 路径、pid-file 位置） - 挂载到
/etc/mysql/conf.d/my.cnf或/etc/mysql/conf.d/custom.cnf更安全，只叠加或覆盖你需要改的项 - 文件名带前缀（如
01-charset.cnf）可控制加载顺序，避免被其他 .cnf 干扰
docker run 命令中挂载 my.cnf 的正确写法
关键在于路径映射和文件命名。宿主机上的配置文件必须以 .cnf 结尾，并挂载进 /etc/mysql/conf.d/ 目录内：
docker run -d \ --name mysql-server \ -v /path/to/host/my.cnf:/etc/mysql/conf.d/my.cnf \ -v /path/to/host/data:/var/lib/mysql \ -e MYSQL_ROOT_PASSWORD=abc123 \ -p 3306:3306 \ mysql:8.0
注意以下几点：
-
/path/to/host/my.cnf必须是完整路径，不能用~/（Docker 不解析 shell tilde） - 宿主机文件需存在，且内容格式合法（INI 风格，
[mysqld]段落开头） - 若挂载的是目录（如
-v ./conf:/etc/mysql/conf.d），则目录下所有.cnf文件都会被加载 - 容器首次启动时，如果
/var/lib/mysql为空，MySQL 会自动初始化；此时你的my.cnf已生效，例如character-set-server=utf8mb4会直接影响初始化库的字符集
常见错误：配置没生效的几个典型原因
挂载成功 ≠ 配置生效。MySQL 启动日志里看不到报错，但 SHOW VARIABLES 显示的仍是默认值，大概率是下面这几个问题：
-
sql_mode写错段落：必须放在[mysqld]下，写在[client]或无段落下会被忽略 - 文件权限问题：宿主机
my.cnf若属主是 root 且权限为600，MySQL 进程（以mysql用户运行）可能无法读取 —— 建议设为644，属主不限 - 拼写错误或语法错误：比如
max_connections = 2048写成max_connection = 2048（少个 s），MySQL 会静默跳过该行，不报错也不生效 - 挂载路径写反：把
-v host_path:container_path写成-v container_path:host_path，结果是空目录被挂进容器，配置根本没进去 - 使用了
--init-file或环境变量覆盖：某些镜像支持MYSQL_INITDB_SKIP_TZINFO=1等变量，它们可能与配置文件冲突，优先级需查对应镜像文档
用 docker-compose.yml 挂载更清晰可控
相比长命令，docker-compose.yml 更易维护，尤其当要同时挂载配置、数据、日志时：
version: '3.8'
services:
mysql:
image: mysql:8.0
container_name: mysql-server
environment:
MYSQL_ROOT_PASSWORD: abc123
volumes:
- ./data:/var/lib/mysql
- ./conf/my.cnf:/etc/mysql/conf.d/my.cnf
- ./logs:/var/log/mysql
ports:
- "3306:3306"这样做的好处：
- 路径相对当前目录，不用写绝对路径，迁移项目时更可靠
- 可配合
./conf/目录下多个.cnf文件做模块化配置（如01-network.cnf、02-charset.cnf） - 启动后可快速验证：
docker exec mysql mysql -uroot -pabc123 -e "SHOW VARIABLES LIKE 'character_set_server';"
真正容易被忽略的是：MySQL 镜像不会校验你挂载的 .cnf 是否语法正确，也不会告诉你某一行被跳过了——它只在启动失败时打印错误。所以每次改完配置，务必进容器执行 mysqld --verbose --help | grep "Default options" 确认加载路径，再用 mysql -e "SHOW VARIABLES" 核对关键项。
