Docker部署PostgreSQL初始化脚本异常：数据库未创建问题排查

问题现象 #

• Docker部署的PostgreSQL容器可通过ssh（psql）和DataGrip正常访问
• 初始化脚本未创建目标数据库；新增角色的脚本执行后，DataGrip角色列表可见新增角色，但psql执行\du无法看到该角色
• 已清理镜像、清空数据目录后重新部署，排除旧数据干扰
• 怀疑psql连接的是群晖本地PostgreSQL，但无法解释“仅创建角色、不创建数据库”的矛盾现象

排查思路 #

1. 确认psql连接的目标实例 #

这是最容易踩的端口冲突坑——如果群晖本地预装了PostgreSQL（默认端口5432），未指定端口/IP的psql请求可能直接连到本地实例：

• 执行psql -h <群晖IP> -p <Docker映射端口> -U <初始配置用户>，强制指定Docker容器的端口
• 用docker inspect <postgres容器名> | grep IPAddress获取容器内部IP，直接用该IP连接psql，再执行\du验证角色，可100%确认连接目标
• 建议将Docker映射端口改为5433这类非默认值，彻底避免与本地服务端口冲突

2. 检查初始化脚本的执行逻辑 #

PostgreSQL官方镜像仅在**首次初始化（数据目录为空）**时执行/docker-entrypoint-initdb.d/下的脚本，需重点排查：

• 核对docker-compose.yml的挂载配置，确保你的脚本目录正确挂载到容器内的/docker-entrypoint-initdb.d/，路径错误会导致脚本完全不执行
• 检查init.sql的语法正确性，比如创建数据库的语句：

  标准写法：
  CREATE DATABASE target_db OWNER target_user;
  语法错误（如漏分号、拼写错误）会导致脚本执行失败，容器日志会记录报错

• 查看容器日志：docker logs <postgres容器名>，搜索initdb或脚本文件名，确认是否有执行报错（如权限不足、SQL语法错误）
• 脚本默认以postgres超级用户执行，不要在脚本中随意切换用户，否则可能导致创建数据库的语句权限不足

3. 排除DataGrip缓存干扰 #

DataGrip存在本地缓存机制，你看到的角色可能是旧缓存数据：

• 在DataGrip中右键点击连接，选择“刷新”，或直接删除旧连接重新创建，指定Docker映射的端口后再查看角色和数据库
• 对比DataGrip的连接参数（IP、端口、用户名）与psql的连接参数，确保两者连接的是同一个实例

4. 检查docker-compose.yml配置 #

参考以下标准配置对比你的文件，排查配置漏洞：

version: '3.8'
services:
  postgres:
    image: postgres:15-alpine  # 避免使用latest，指定版本更稳定
    container_name: postgres-db
    environment:
      POSTGRES_USER: admin
      POSTGRES_PASSWORD: your_strong_password
      POSTGRES_DB: default_db  # 初始默认数据库，请勿与脚本中创建的数据库重名
    ports:
      - "5433:5432"  # 避开群晖本地默认的5432端口
    volumes:
      - ./postgres-data:/var/lib/postgresql/data  # 数据目录，群晖上需确保Docker用户有读写权限
      - ./init-scripts:/docker-entrypoint-initdb.d/  # 初始化脚本挂载目录
    restart: always

• 若脚本中创建的数据库与POSTGRES_DB重名，初始化阶段只会创建一次，不会重复执行
• 群晖上的挂载目录需给Docker用户组分配读写权限，否则容器无法读取脚本文件

5. 确认脚本执行顺序 #

若存在多个初始化脚本，官方镜像会按文件名排序执行，顺序错误可能导致依赖失败：

• 给脚本添加数字前缀（如01-create-user.sql、02-create-db.sql），保证创建角色的脚本先于创建数据库的脚本执行

快速验证步骤 #

1. 停止容器：docker-compose down
2. 彻底删除数据目录：在群晖File Station中直接删除对应的postgres-data文件夹，避免残留旧数据
3. 修改docker-compose.yml，将映射端口改为5433（避开本地5432）
4. 重启容器：docker-compose up -d
5. 用psql连接容器实例：psql -h <你的群晖IP> -p 5433 -U admin
6. 执行\l查看数据库列表，\du查看角色列表
7. 检查容器日志：docker logs postgres-db，确认脚本执行状态

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