Docker Compose部署PostgreSQL时初始化脚本执行但未建表问题排查

1. 数据卷已存在，初始化脚本未重复执行 #

PostgreSQL官方镜像的/docker-entrypoint-initdb.d目录下的脚本仅在容器首次启动、数据目录为空时执行。若此前容器已启动过，对应数据卷（或绑定挂载目录）中已有初始化后的数据库文件，后续重启容器时脚本不会再次运行。你看到的日志可能是首次启动的残留记录，或是日志路径拼写错误（比如你提供的日志里initeb应为initdb）。

解决：

• 彻底清理数据卷后重启：docker-compose down -v
• 若用绑定挂载，手动删除挂载目录下的所有文件，再启动容器

2. 脚本未指定目标数据库，表建在默认postgres库 #

初始化脚本默认连接到镜像自带的postgres数据库，若你应用或手动连接时用的是自定义数据库，自然看不到表。而手动运行脚本时，你大概率是在目标数据库里执行的，所以能正常创建。

解决：

• 在脚本开头添加\c 你的目标数据库名，指定执行脚本的数据库
• 或在CREATE TABLE语句中明确指定库名：CREATE TABLE 你的库名.public.表名 (...)

3. 表建在非public schema下，查询未指定schema #

如果脚本里指定了非public的schema（如CREATE TABLE my_schema.表名 (...)），而你查询时默认只查public schema，就看不到表。手动运行脚本时可能已切换到对应schema，所以能看到结果。

解决：

• 查询时指定schema：SELECT * FROM my_schema.表名;
• 或在脚本中设置默认schema：ALTER ROLE pg SET search_path TO my_schema, public;

4. 日志来自旧容器实例 #

若创建过多个容器，你看到的日志可能属于旧实例，当前运行的容器并未实际执行脚本。

解决：

• 查看当前容器实时日志：docker-compose logs -f postgres
• 直接查看当前容器ID的日志：docker logs <容器ID>

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