Docker启动MySQL容器失败原因分析及排查记录

常见失败原因

1. 端口冲突

   • 主机端口已被占用
   • 容器端口映射配置错误

2. 数据卷问题

   • 挂载目录权限不足
   • 挂载路径不存在
   • 数据卷冲突

3. 配置问题

   • 环境变量设置错误
   • 配置文件格式错误
   • 内存分配不足

4. 镜像问题

   • 镜像版本不兼容
   • 镜像损坏
   • 拉取镜像不完整

5. 资源限制

   • 内存不足
   • 存储空间不足
   • CPU资源限制

排查步骤

1. 查看容器日志

docker logs [容器ID或名称]

2. 检查端口占用

# 查看主机端口占用情况
netstat -tulnp | grep [端口号]
# 或
lsof -i :[端口号]

3. 检查数据卷权限

# 查看挂载目录权限
ls -ld [挂载目录]
# 确保MySQL用户(通常UID 999)有权限
sudo chown -R 999:999 [挂载目录]

4. 尝试简单启动测试

# 使用最小配置启动测试
docker run --name mysql-test -e MYSQL_ROOT_PASSWORD=my-secret-pw -d mysql:tag

5. 检查系统资源

# 查看Docker资源使用
docker stats
# 查看系统资源
free -h
df -h

常见错误及解决方案

错误1: 端口已被占用

Error response from daemon: driver failed programming external connectivity on endpoint mysql (xxxx): Bind for 0.0.0.0:3306 failed: port is already allocated

解决方案: - 更改主机端口映射，如 -p 3307:3306 - 停止占用端口的服务 - 使用 docker ps 查找并停止冲突容器

错误2: 权限不足

[ERROR] [Entrypoint]: mysqld failed while attempting to check config
command was: mysqld --verbose --help
mysqld: Can't create/write to file '/var/lib/mysql/is_writable' (Errcode: 13 - Permission denied)

解决方案:

sudo chown -R 999:999 [挂载目录]
sudo chmod -R 755 [挂载目录]

错误3: 数据目录不为空

[ERROR] [Entrypoint]: Data directory (/var/lib/mysql) already exists and is not empty. This could be because you've already started MySQL previously with a different root password. To fix this, either delete the contents of the directory or specify a different data directory.

解决方案: - 清空数据目录或指定新的数据目录 - 或添加 --force 参数强制使用(不推荐)

错误4: 内存不足

[ERROR] [Entrypoint]: MYSQL_ALLOW_EMPTY_PASSWORD is set but not MYSQL_ROOT_PASSWORD or MYSQL_RANDOM_ROOT_PASSWORD

解决方案: - 确保设置了必要的环境变量 - 示例正确启动命令:

docker run --name mysql -e MYSQL_ROOT_PASSWORD=yourpassword -d mysql:tag

完整排查示例

1. 尝试启动MySQL容器失败:

docker run --name mysql -e MYSQL_ROOT_PASSWORD=password -p 3306:3306 -v /data/mysql:/var/lib/mysql -d mysql:5.7

2. 查看日志发现错误:

docker logs mysql

3. 发现是权限问题后修复:

sudo chown -R 999:999 /data/mysql

4. 重新启动容器:

docker start mysql

预防措施

1. 使用docker-compose管理MySQL服务
2. 预先创建并配置好数据目录
3. 记录使用的环境变量和配置
4. 定期备份重要数据
5. 使用特定版本标签而非latest

通过以上步骤，大多数Docker MySQL启动问题都能得到有效解决。如问题仍然存在，建议查阅MySQL官方文档或Docker社区获取更详细的帮助。