Docker 数据库无法启动问题排查指南

当 Docker 中的数据库无法启动时，可以按照以下步骤进行排查和解决：

1. 检查容器状态

docker ps -a  # 查看所有容器状态
docker logs <container_name_or_id>  # 查看特定容器的日志

2. 常见问题及解决方案

2.1 端口冲突

现象：端口已被占用错误

Error starting userland proxy: listen tcp 0.0.0.0:3306: bind: address already in use

解决方案： - 停止占用端口的服务 - 或修改数据库容器的映射端口：

docker run -p 3307:3306 mysql

2.2 数据卷权限问题

现象：权限被拒绝错误

chown: changing ownership of '/var/lib/mysql/': Permission denied

解决方案： - 对于 MySQL/MariaDB：

docker run -v /my/own/datadir:/var/lib/mysql -e MYSQL_ROOT_PASSWORD=my-secret-pw mysql

• 或预先设置正确的目录权限

2.3 配置文件错误

现象：配置文件语法错误导致启动失败

解决方案： - 检查挂载的配置文件 - 对于 MySQL 可以尝试：

docker run --name some-mysql -v /my/custom:/etc/mysql/conf.d mysql

2.4 资源不足

现象：内存不足或磁盘空间不足

解决方案： - 增加 Docker 资源分配 - 清理无用镜像和容器：

docker system prune

2.5 数据库损坏

现象：数据库文件损坏导致无法启动

解决方案： - 对于 MySQL 可以尝试恢复模式：

docker run --name some-mysql -e MYSQL_ROOT_PASSWORD=my-secret-pw -e MYSQL_ALLOW_EMPTY_PASSWORD=yes mysql --innodb_force_recovery=1

3. 数据库特定解决方案

MySQL/MariaDB

# 检查错误日志
docker exec -it mysql_container cat /var/log/mysql/error.log

# 常见修复命令
docker exec -it mysql_container mysql_upgrade -u root -p

PostgreSQL

# 进入恢复模式
docker run -e POSTGRES_USER=postgres -e POSTGRES_PASSWORD=mysecretpassword postgres postgres --single

MongoDB

# 修复数据库
docker exec -it mongodb mongo --eval "db.repairDatabase()"

4. 高级排查技巧

1. 进入容器内部检查：

docker exec -it <container_id> /bin/bash

2. 检查数据库进程：

ps aux | grep mysql  # 或 postgres, mongod 等

3. 查看系统日志：

docker exec -it <container_id> cat /var/log/syslog

4. 尝试临时容器：

docker run -it --rm mysql bash

如果以上方法都无法解决问题，建议： - 备份数据卷 - 删除并重新创建容器 - 从备份恢复数据

希望这些步骤能帮助您解决 Docker 数据库启动问题！