Docker PostgreSQL容器初始化Schema失败，未创建指定库表求助

我来帮你梳理下可能遗漏的关键步骤，毕竟用Docker部署PostgreSQL时，初始化脚本的执行逻辑有几个容易忽略的细节：

• 检查初始化脚本的存放路径
  PostgreSQL官方镜像的entrypoint会自动执行/docker-entrypoint-initdb.d/目录下的.sql、.sh或.sql.gz文件，但前提是你得把脚本放到这个路径里。看看你的Dockerfile里是不是写对了COPY命令？正确的写法应该是：

  COPY postgres.sql /docker-entrypoint-initdb.d/
  

  如果路径写错，脚本根本不会被执行。

• 确认环境变量配置
  要自动创建my_db数据库，你需要在docker-compose.yml里设置对应的环境变量：

  services:
    postgres:
      # ... 其他配置
      environment:
        POSTGRES_DB: my_db
        POSTGRES_USER: your_username
        POSTGRES_PASSWORD: your_password
  

  如果没设置POSTGRES_DB，默认只会创建和POSTGRES_USER同名的数据库，你的脚本如果没指定库的话，表可能建到默认库里去了。

• 检查SQL脚本的内容逻辑
  如果你的脚本直接写CREATE TABLE my_table (...)，但没有先切换到my_db，那要看初始化时的连接库：

  • 如果你已经设置了POSTGRES_DB=my_db，初始化脚本会自动在这个库里执行，直接建表就行；
  • 如果没设置这个环境变量，脚本里需要先创建库再切换：

    CREATE DATABASE IF NOT EXISTS my_db;
    \c my_db; -- PostgreSQL用这个命令切换数据库
    CREATE TABLE my_table (
      -- 表结构
    );
    

• 清理旧的数据卷缓存
  PostgreSQL的初始化脚本只会在第一次创建数据卷时执行。如果你之前已经启动过容器，数据卷里已经有初始化后的数据库文件，就算修改了脚本，重新up也不会再执行脚本。解决方法是删除旧卷后重新启动：

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

• 验证文件权限
  容器里的postgres用户需要能读取你的初始化脚本。可以在Dockerfile里加上权限设置：

  COPY postgres.sql /docker-entrypoint-initdb.d/
  RUN chown postgres:postgres /docker-entrypoint-initdb.d/postgres.sql
  

  不然脚本可能因为权限不足被跳过。

• 确认Dockerfile的基础镜像
  确保你的Dockerfile用的是官方PostgreSQL镜像，比如：

  FROM postgres:15-alpine # 或者其他版本
  

  第三方镜像可能修改了entrypoint逻辑，不会自动执行/docker-entrypoint-initdb.d/下的脚本。

你可以按照上面的顺序逐一排查，大概率能找到问题所在～

内容的提问来源于stack exchange，提问作者Cheok Yan Cheng