为何通过/docker-entrypoint-initdb.d/脚本创建的PostgreSQL扩展无法被导出？

问题背景 #

通过Docker的/docker-entrypoint-initdb.d/*初始化脚本创建PostgreSQL扩展时，使用单用户模式执行SQL：

gosu postgres postgres --single -jE <<EOSQL
  CREATE EXTENSION citext;
  CREATE EXTENSION pgcrypto;
  CREATE EXTENSION hstore;
  CREATE EXTENSION unaccent;
  CREATE EXTENSION pg_trgm;
EOSQL

但用pg_dump -U postgres -d userdb或pg_dumpall -U postgres导出时，这些扩展不会出现在导出文件里，导致恢复失败。而手动连接数据库执行DROP/CREATE EXTENSION后，扩展就能正常被导出恢复。PostgreSQL版本为11.12。

核心疑问解析：你的CREATE EXTENSION属于SQL脚本执行吗？ #

是的，原因在于你用了postgres --single单用户模式执行SQL。
单用户模式是PostgreSQL的紧急修复模式，它绕过了常规的客户端连接层，直接读取执行SQL语句。这种模式下创建的扩展，PostgreSQL会将其标记为"系统脚本级操作"，而非用户通过常规交互式连接创建的数据库对象。pg_dump在导出时，默认会过滤掉这类系统级脚本创建的扩展，因为它认为这类操作是数据库初始化的底层修改，不属于用户数据库的常规业务对象范畴。

解决方案 #

替换单用户模式的执行方式，改用常规psql客户端连接执行扩展创建，这样PostgreSQL会正确记录扩展的归属和创建上下文，pg_dump就能正常识别并导出。

方式1：单条命令执行 #

gosu postgres psql -d userdb -c "CREATE EXTENSION citext;"
gosu postgres psql -d userdb -c "CREATE EXTENSION pgcrypto;"
gosu postgres psql -d userdb -c "CREATE EXTENSION hstore;"
gosu postgres psql -d userdb -c "CREATE EXTENSION unaccent;"
gosu postgres psql -d userdb -c "CREATE EXTENSION pg_trgm;"

方式2：批量SQL文件执行 #

1. 在/docker-entrypoint-initdb.d/目录下创建init_extensions.sql文件：

CREATE EXTENSION citext;
CREATE EXTENSION pgcrypto;
CREATE EXTENSION hstore;
CREATE EXTENSION unaccent;
CREATE EXTENSION pg_trgm;

2. 在初始化脚本中执行该文件：

gosu postgres psql -d userdb -f /docker-entrypoint-initdb.d/init_extensions.sql

验证 #

执行完初始化脚本后，登录psql执行\dx命令，确认扩展已归属userdb数据库，此时再用pg_dump导出，就能在导出文件中看到CREATE EXTENSION语句，恢复时也能正常创建扩展。

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