直接用官方镜像启动 MySQL 容器最稳妥
MySQL 官方 Docker 镜像（
mysql:8.0或
mysql:5.7）已预置初始化逻辑和权限模型，比自己从基础镜像构建更可靠。不建议用
debian或
alpine自建，容易遗漏
mysqld初始化步骤，导致容器反复重启或
Access denied错误。
启动前需明确：是否需要持久化数据、是否要自定义配置、是否暴露端口给宿主机。常见错误是忽略
-v挂载
/var/lib/mysql，容器一删，数据库就彻底丢失。 用
docker run启动时，必须指定
MYSQL_ROOT_PASSWORD环境变量，否则容器会退出并报错
MYSQL_ROOT_PASSWORD not set若需兼容旧应用，可加
MYSQL_ALLOW_EMPTY_PASSWORD=yes，但仅限测试环境 默认监听
0.0.0.0:3306，如只允许本地连接，启动时加
--bind-address=127.0.0.1（需挂载自定义
my.cnf）
挂载自定义 my.cnf 配置文件的关键写法
Docker 中 MySQL 不读取宿主机的
/etc/mysql/my.cnf，必须通过
-v映射到容器内
/etc/mysql/conf.d/或
/etc/mysql/mysql.conf.d/下，且文件后缀必须为
.cnf。放在
/etc/mysql/my.cnf顶层路径会被忽略。
常见错误是把配置写成
[mysqld]段但漏掉
skip-host-cache或
skip-name-resolve，导致容器启动慢甚至卡住——这是 DNS 解析失败引起的。
docker run -d \ --name mysql-dev \ -e MYSQL_ROOT_PASSWORD=devpass \ -v $(pwd)/my-custom.cnf:/etc/mysql/conf.d/custom.cnf \ -v $(pwd)/data:/var/lib/mysql \ -p 3306:3306 \ -d mysql:8.0
my-custom.cnf示例内容（仅覆盖必要项，不全量复制官方配置）：
[mysqld] character-set-server=utf8mb4 collation-server=utf8mb4_unicode_ci skip-host-cache skip-name-resolve innodb_buffer_pool_size=256M
初始化 SQL 脚本自动执行的触发条件
MySQL 容器启动时，会自动执行
/docker-entrypoint-initdb.d/目录下所有
.sql、
.sql.gz或
.sh文件，但**仅当数据目录为空（首次初始化）时生效**。如果已挂载非空
/var/lib/mysql，脚本将被跳过——这点极易被忽略。 脚本必须是 UTF-8 编码，含中文注释或表名时，BOM 头会导致语法错误 SQL 文件中不要用
CREATE DATABASE，因为
MYSQL_DATABASE环境变量已自动创建库；重复创建会报错中断初始化 若需创建非 root 用户，必须在脚本末尾显式执行
FLUSH PRIVILEGES;，否则权限不生效
示例初始化脚本
init.sql：
CREATE USER 'appuser'@'%' IDENTIFIED BY 'apppass'; GRANT ALL ON myapp.* TO 'appuser'@'%'; FLUSH PRIVILEGES;
连接容器内 MySQL 的实际验证方式
别依赖
localhost连接。在容器内用
mysql -h 127.0.0.1 -P 3306 -u root -p；从宿主机连接则用
mysql -h 127.0.0.1 -P 3306 -u root -p（不是
localhost），因为 macOS / Windows 的 Docker Desktop 会把
localhost解析为宿主机而非容器网关。
常见连不上原因：防火墙拦截
3306端口、MySQL 用户未授权
%主机、
bind-address设为
127.0.0.1且没改配置。
调试命令：
docker logs mysql-dev # 查看初始化是否成功 docker exec -it mysql-dev mysql -uroot -p # 进入容器手动连 netstat -tuln | grep :3306 # 宿主机确认端口是否监听
字符集问题常出现在客户端连接后查出乱码，此时检查三处：容器内
my.cnf的
character-set-server、连接时加
--default-character-set=utf8mb4、建表语句是否带
CHARSET=utf8mb4。
