Docker部署MariaDB容器启动后未自动创建表求助

以下是几个常见的排查方向和解决办法：

1. 确认初始化脚本的执行条件 #

MariaDB官方镜像只会在首次启动且数据库目录为空时执行/docker-entrypoint-initdb.d下的脚本。如果之前已经启动过容器，数据卷中已有数据库文件，脚本不会重复执行。

• 解决：删除现有数据卷后重新启动

  docker-compose down -v
  docker-compose up -d
  

2. 检查SQL脚本的正确性 #

你的脚本虽然指定了数据库，但建议先切换到目标库，避免默认在其他库创建表；同时添加IF NOT EXISTS防止重复创建报错中断脚本执行：

USE checkitDB;
CREATE TABLE IF NOT EXISTS tasks (
    id VARCHAR(255) NOT NULL,
    title VARCHAR(32) NOT NULL,
    description TEXT NOT NULL,
    PRIMARY KEY (id)
);

3. 验证脚本的挂载与权限 #

• 确保./initDB目录下只有initDB.sql脚本，且文件名后缀为.sql（镜像只会执行.sql/.sh等指定后缀的文件）
• Linux环境下，检查宿主目录权限：容器内的mysql用户（UID 999）需要能读取脚本文件

  chmod -R 755 ./initDB
  # 或者直接修改归属
  chown -R 999:999 ./initDB
  

4. 检查镜像配置 #

你使用了build: .构建自定义镜像，如果Dockerfile中修改了ENTRYPOINT或CMD，可能破坏了官方镜像的初始化逻辑。建议先改用官方镜像测试：
修改docker-compose.yml的db服务：

services:
  db:
    image: mariadb:latest # 替换build: .
    ports:
      - "3306:3306"
    environment:
      MYSQL_DATABASE: checkitDB
      MYSQL_USER: myuser
      MYSQL_PASSWORD: mypassword
      MYSQL_ROOT_PASSWORD: rootpassword
    volumes:
      - ./initDB:/docker-entrypoint-initdb.d

5. 查看容器日志定位错误 #

启动容器后，查看日志确认脚本是否执行或存在报错：

docker-compose logs db

日志中如果出现Executing /docker-entrypoint-initdb.d/initDB.sql说明脚本已执行；如果有SQL语法错误、权限不足等信息，可针对性修复。

内容的提问来源于stack exchange，提问作者Terrell-byte