Docker Compose启动PostgreSQL时自动创建额外超级用户的配置方法

原有配置的错误点 #

• 直接将SQL语句写入command字段的写法完全无效：PostgreSQL官方镜像的command参数默认用于传入数据库服务启动命令，直接传入SQL既不会被数据库引擎识别执行，还会直接导致数据库服务启动失败。
• 配置中SQL语句里混用shell管道符|，属于语法错误，SQL语法不支持该写法。

推荐实现方式（官方原生支持） #

PostgreSQL官方镜像原生提供了首次启动自动执行初始化脚本的机制：当数据卷为空、容器第一次启动时，会自动按文件名排序执行/docker-entrypoint-initdb.d/目录下的所有.sql、.sql.gz、.sh文件，执行完成后才会对外提供数据库服务，完全满足初始化建用户的需求，不会出现时序问题。

1. 在docker-compose.yml同级目录创建初始化SQL文件，命名为init-extra-user.sql，写入需要执行的建用户语句，示例（按需替换用户名、密码）：

-- 示例1：创建名为postgres的超级用户，替换密码为你自己的配置
CREATE ROLE postgres LOGIN SUPERUSER PASSWORD 'your_strong_password';
ALTER USER postgres CREATEDB CREATEROLE INHERIT REPLICATION BYPASSRLS;

-- 如果是给服务B创建独立超级用户，用下面的语句替换即可
-- CREATE ROLE service_b LOGIN SUPERUSER PASSWORD 'service_b_password';
-- ALTER USER service_b CREATEDB CREATEROLE INHERIT REPLICATION BYPASSRLS;

2. 修改docker-compose中PostgreSQL服务的配置，删除原错误的command字段，新增初始化脚本的挂载配置，正确配置片段如下：

postgres:
    image: postgres:13.4
    container_name: postgresql
    hostname: postgresql
    volumes:
      - 'postgres_data:/var/lib/postgresql/data'
      # 挂载本地初始化脚本到容器的初始化目录
      - './init-extra-user.sql:/docker-entrypoint-initdb.d/init-extra-user.sql'
    environment:
      POSTGRES_DB: keycloak
      POSTGRES_USER: keycloak
      POSTGRES_PASSWORD: password

注意事项 #

• 初始化脚本仅在数据卷为空、容器第一次启动时执行。如果之前已经启动过PostgreSQL容器、postgres_data卷中已经存在初始化完成的数据库文件，需要先删除旧数据卷再启动，否则初始化脚本不会触发。
• 新建的超级用户必须设置密码，否则默认仅支持本地socket登录，TCP远程连接会被认证拒绝。
• 不推荐通过覆写command字段的方式执行初始化SQL：这种方式需要手动处理数据库启动、执行SQL、重启服务的时序逻辑，很容易出现权限错误、启动失败、初始化不生效的问题。

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