Debian系VirtualBox中Docker Compose部署MariaDB遇权限拒绝问题

问题描述 #

在Debian系统的VirtualBox环境中，通过指定的docker-compose.yaml部署mydb（MariaDB）和frontend（phpMyAdmin）服务，执行docker compose up -d后出现以下问题：

• mydb服务健康检查报错：mariadb-admin: Access denied for user root@127.0.0.1 (using password: NO)
• 进入容器执行docker exec dockercompose-mydb-1 service mariadb status时，同样报上述权限错误，重启MariaDB服务后问题依旧

问题原因 #

1. 健康检查命令未携带root密码，导致无权限执行mariadb-admin ping操作
2. mydb的Dockerfile存在镜像名称拼写错误（mariabd:latest应为mariadb:latest）
3. 在容器内使用service mariadb status检查状态的方式错误，容器中通常不运行systemd服务，无法通过该命令判断服务状态

修复步骤 #

1. 修正mydb的Dockerfile拼写错误 #

将db目录下的Dockerfile中的镜像名称修正为正确的mariadb:latest：

FROM mariadb:latest
RUN apt-get update && apt-get install -y iputils-ping

2. 更新健康检查命令，添加密码参数 #

修改docker-compose.yaml中mydb服务的healthcheck配置，在mariadb-admin ping命令中加入root密码参数：

healthcheck:
  test: ["CMD-SHELL", "mariadb-admin ping -h localhost --protocol=tcp -p$$MYSQL_ROOT_PASSWORD"]
  interval: 10s
  timeout: 15s
  retries: 5

使用$$MYSQL_ROOT_PASSWORD可以正确引用容器内的环境变量，避免docker-compose解析变量时出现问题。

3. 正确检查容器内MariaDB状态 #

放弃使用service mariadb status，改用以下命令验证服务状态：

# 使用mariadb-admin验证连通性
docker exec dockercompose-mydb-1 mariadb-admin ping -h localhost -proot
# 或者查看容器内MariaDB进程
docker exec dockercompose-mydb-1 ps aux | grep mariadb

4. 清理旧数据卷并重建容器（如果配置已损坏） #

如果之前的数据卷已经存在错误的权限或配置残留，需要清理后重新部署：

# 停止并删除现有容器
docker compose down
# 删除旧的数据卷
docker volume rm dockercompose_server_db
# 重新构建镜像并启动服务
docker compose up -d --build

内容的提问来源于stack exchange，提问作者Nikulin Nikita