Docker中MariaDB容器状态异常，无法访问数据库求助

核心问题分析 #

1. 环境变量错误：MariaDB官方镜像的用户密码环境变量是MYSQL_PASSWORD，你写成了MYSQL_PASS，导致test用户未被正确创建，直接触发登录权限错误。
2. 健康检查命令语法错误：命令里的转义引号\"是多余的，会被shell解析为无效字符，引发": command not found报错。
3. 旧数据卷残留：本地挂载的./mounts/mariadb目录可能保留了之前的数据库数据，里面没有你配置的test用户，导致新配置不生效。
4. 健康检查间隔过短：1秒的检查间隔远快于MariaDB的启动速度，服务还未初始化完成就被判定为不健康。

修正后的Docker Compose配置 #

version: "3.9"
services:
  dbs:
    build: .
    ports:
      - "8000:8000"
  mariadb:
    container_name: ${APP_NAME}_mariadb
    image: mariadb
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: root
      MYSQL_USER: test
      # 修正：把MYSQL_PASS改成官方要求的MYSQL_PASSWORD
      MYSQL_PASSWORD: pass
      MYSQL_DATABASE: filecoin_dbs
    ports:
      - 3306:3306
    healthcheck:
      # 修正：去掉转义引号，改用更轻量的mysqladmin做健康检查
      test: ["CMD", "mysqladmin", "ping", "-utest", "-ppass", "-h", "localhost", "--silent"]
      # 修正：调长检查间隔，给MariaDB足够的启动时间
      interval: 5s
      timeout: 5s
      retries: 10
    volumes:
      - ./mounts/mariadb:/var/lib/mysql
  dbs_filecoin:
    container_name: filecoin
    build: ./services/dbs_filecoin/
    env_file: .env
    depends_on:
      mariadb:
        condition: service_healthy

操作步骤 #

1. 清理旧数据与容器
   先停止并删除所有相关容器，同时清理本地挂载的数据库目录（如果不需要保留旧数据）：

   docker-compose down -v
   rm -rf ./mounts/mariadb
   

2. 启动服务
   重新构建并启动服务：

   docker-compose up --build
   

3. 验证登录
   进入MariaDB容器验证登录是否正常：

   docker exec -it ${APP_NAME}_mariadb bash
   # 用test用户登录指定数据库
   mariadb -utest -ppass filecoin_dbs
   # 或者用root用户登录（输入密码root）
   mariadb -uroot -proot
   

额外说明 #

• 用mysqladmin ping做健康检查比执行SELECT 1更轻量，适合快速验证服务存活状态。
• 如果需要保留旧数据，不要删除./mounts/mariadb目录，而是进入容器手动创建授权test用户：

  CREATE USER 'test'@'localhost' IDENTIFIED BY 'pass';
  GRANT ALL PRIVILEGES ON filecoin_dbs.* TO 'test'@'localhost';
  FLUSH PRIVILEGES;
  

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