不能只靠 docker run 启动官方镜像直接运行 MySQL 8.0，因其默认配置（UTC时区、latin1字符集、max_connections=151、innodb_buffer_pool_size偏小）不满足开发/测试需求，且无初始化脚本支持、配置不可复现、权限与认证兼容性差，导致 emoji 存储失败、时间错乱、连接不足、客户端无法连接等问题。
为什么不能只靠 docker run 启动官方镜像
直接运行 mysql:8.0 镜像，容器启动后 MySQL 会用默认配置跑起来：时区是 UTC、字符集是 latin1、max_connections 是 151、innodb_buffer_pool_size 按容器内存自动算但往往偏小。这些在开发环境可能凑合，但一上测试或预发，emoji 存不进去、时间字段对不上、慢查询日志没开、连接数不够用——问题全得手动进容器改配置、重启服务，还无法复现。
更关键的是，官方镜像不执行初始化脚本（比如建库、授权、导入基础表），每次重装都要人肉连上去跑一遍 SQL。团队协作时，没人能保证“你本地的 MySQL 和 CI 流水线里跑的是一套配置”。
Dockerfile 必须覆盖的四个核心环节
一个真正可用的自定义 MySQL 镜像，Dockerfile 要完成四件事，缺一不可：
- 替换默认配置：把自定义
my.cnf复制到/etc/mysql/conf.d/（官方镜像只认这个路径下的.cnf文件） - 注入初始化逻辑：把
.sql或.sh脚本放进/docker-entrypoint-initdb.d/，容器首次启动时自动执行 - 设置可信环境变量：只用官方支持的
MYSQL_ROOT_PASSWORD等变量，避免硬编码密码；生产环境应通过--env-file注入 - 适配 UID/GID 权限：官方镜像中 MySQL 进程以 UID 999 运行，所以挂载宿主机目录前必须
chown -R 999:999，否则启动失败报错mysqld: Can't create/write to file
my.cnf 配置里最容易被忽略的三个坑
很多人抄了网上的配置，但容器一跑就报错或行为异常，问题常出在这三处：
-
default_authentication_plugin=mysql_native_password：MySQL 8.0 默认用caching_sha2_password，但很多旧版客户端（如 Navicat 12、某些 Python MySQL 驱动）不支持，连不上就卡死；加这行才能兼容 -
lower_case_table_names=1：仅在**数据目录为空时生效**；如果已挂载了旧数据卷，再加这行会导致启动失败，报错Unknown table engine 'InnoDB'；务必确认首次部署才启用 -
skip-character-set-client-handshake：不加这行，客户端即使声明了utf8mb4，MySQL 仍可能按latin1解析请求，导致 emoji 存成???
其他关键项建议直接照搬：character-set-server=utf8mb4、collation-server=utf8mb4_0900_ai_ci、default-time-zone='+08:00'、innodb_buffer_pool_size 设为容器内存的 50%～70%（例如 2G 内存设 1G）。
构建与验证命令要严格匹配镜像行为
构建完别急着跑，先验证配置是否真被加载：
- 构建命令必须指定上下文路径，且
my.cnf和init.sql要和Dockerfile在同一目录：docker build -t my-mysql:8.0.36 . - 启动时禁用密码变量（让初始化脚本控制账号），并挂载空数据目录：
docker run -v $(pwd)/data:/var/lib/mysql -p 3306:3306 --rm my-mysql:8.0.36 - 进容器检查：
docker exec -it <container-id> mysql --defaults-extra-file=/etc/mysql/conf.d/my.cnf -uroot -p -e "SHOW VARIABLES LIKE 'character_set%';"</container-id>，确认输出全是utf8mb4 - 查初始化结果：
mysql -uroot -p -e "SELECT SCHEMA_NAME FROM INFORMATION_SCHEMA.SCHEMATA WHERE SCHEMA_NAME = 'myapp';"，确保init.sql里的CREATE DATABASE生效
真正的难点不在写 Dockerfile，而在于每次修改配置后，必须清空 /var/lib/mysql 目录重来——MySQL 不允许热更新 server-id、字符集等底层参数，强行复用旧数据目录只会启动失败。
