mysql在Docker中安装与配置的详细流程

官方镜像启动MySQL最稳妥，需挂载数据卷、配置文件和初始化脚本，指定ROOT密码，注意字符集与连接方式。

直接用官方镜像启动 MySQL 容器最稳妥

MySQL 官方 Docker 镜像（mysql:8.0 或 mysql:5.7）已预置初始化逻辑和权限模型，比自己从基础镜像构建更可靠。不建议用 debian 或 alpine 自建，容易遗漏 mysql

启动前需明确：是否需要持久化数据、是否要自定义配置、是否暴露端口给宿主机。常见错误是忽略 -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。