【045】由Docker的MySQL官方镜像配置的容器无法启动问题的解决办法

这篇文章记录了我在使用 Docker 的 MySQL 官方镜像的时候碰到的一个问题。MySQL 的版本是 5.7。

问题描述

我使用的是MySQL的Docker镜像。先创建并启动镜像：

# docker run --name mysql-b \
> -p 33002:3306 -v /zc/mysql/datadir-b:/var/lib/mysql \
> -e MYSQL_ROOT_PASSWORD='123456' -d mysql:latest

正常启动，没有问题。通常我们使用MySQL的时候，需要设置参数。要设置参数，我们先得进入容器的bash，进行操作：

docker exec -it mysql-b bash

MySQL的默认配置文件是 /etc/mysql/my.cnf 文件。如果想要自定义配置，建议向 /etc/mysql/conf.d 目录中创建 .cnf 文件。新建的文件可以任意起名，只要保证后缀名是 cnf 即可。新建的文件中的配置项可以覆盖 /etc/mysql/my.cnf 中的配置项。因为 MySQL 的 Docker 官方镜像没有提供 vim 编辑器，所以我用cat命令生成文件并添加内容：

# cat >test.cnf <<EOF
[mysqldump]
user=root
password='123456'
[mysqld]
max_allowed_packet=8M
lower_case_table_names=1
character_set_server=utf8
max_connections=900
max_connect_errors=600
default-character-set=utf8
EOF

退出后，停止容器，再重新启动容器，发现容器无法启动。

解决方法

删除原来那个不能启动的容器。重新创建一个新的容器。问题的关键在于原来的 test.cnf 文件有错误。找到原来配置文件的最后一行：

default-character-set=utf8

把这一行删除。添加配置文件的时候保证没有这一行就可以了。

问题原因

MySQL 的官方 Docker 镜像里面，在标签 latest 下，[mysqld] 这一配置段上并没有 default-character-set 这一配置项。
如果你要查看所有的配置项，可以使用如下命令，利用管道将输出的帮助都放到 help.txt 文件里面：

docker run -it --rm mysql:tag --verbose --help > help.txt

其中 tag 表示镜像的标签，比如 latest 和 5.6。