如何在构建Postgres Docker镜像时初始化自定义数据库？

我明白你的痛点——想把庞大的自定义Postgres数据库直接打包进镜像里，避免每次启动容器都跑初始化脚本，还得保证测试场景下数据不持久化。之前的做法为啥不行？我来给你捋清楚，再给你一套靠谱的解决方案。

首先得搞懂官方Postgres镜像的核心机制：/docker-entrypoint-initdb.d/里的脚本只有在容器第一次启动、且数据目录（默认/var/lib/postgresql/data）为空的时候才会执行。你之前在构建镜像时看到脚本执行，其实是在构建阶段的临时容器里跑的，但这些执行结果根本不会保留到最终镜像里——因为构建时的Postgres数据目录还没被正式初始化，而且构建完成后临时容器的内容会被丢弃，只有COPY/RUN命令的变更会被打包进镜像。

那正确的思路是：在构建镜像的过程中，手动完成数据库的初始化，把已经填充好数据的/data目录直接打包进镜像。这样启动容器时，Postgres会直接使用镜像里预初始化好的数据，不会再跑初始化脚本，也不需要绑定卷，每次启动都是干净的镜像内数据，完美适配自动化测试场景。

下面是具体的实现步骤，给你一个可复用的Dockerfile示例：

# 基于官方Postgres镜像，可替换成你需要的版本，比如15-alpine
FROM postgres:latest

# 设置Postgres初始化必需的环境变量，这些会被initdb和后续脚本使用
ENV POSTGRES_USER=test_user
ENV POSTGRES_PASSWORD=test_pass
ENV POSTGRES_DB=my_custom_db

# 把你的初始化脚本和大SQL文件复制到镜像里的指定目录
COPY init-db.sh /docker-entrypoint-initdb.d/
COPY your_large_db.sql /docker-entrypoint-initdb.d/

# 关键步骤：手动初始化数据库并填充数据，把结果保留到镜像的/data目录
RUN mkdir -p /var/lib/postgresql/data && \
    # 确保数据目录权限正确，Postgres进程只能用postgres用户操作
    chown -R postgres:postgres /var/lib/postgresql/data && \
    # 切换到postgres用户，执行initdb初始化空数据库
    su postgres -c "initdb -D /var/lib/postgresql/data" && \
    # 临时启动Postgres服务，加上-w等待服务完全就绪
    su postgres -c "pg_ctl -D /var/lib/postgresql/data start -w" && \
    # 执行你的SQL文件（如果用init-db.sh脚本，就换成执行这个脚本）
    su postgres -c "psql -U $POSTGRES_USER -d $POSTGRES_DB -f /docker-entrypoint-initdb.d/your_large_db.sql" && \
    # 停止临时Postgres服务，加上-w确保数据完全写入磁盘
    su postgres -c "pg_ctl -D /var/lib/postgresql/data stop -w"

# 最后再确认一次数据目录的权限，避免后续启动出现问题
RUN chown -R postgres:postgres /var/lib/postgresql/data

几个关键注意点： #

• 镜像体积：因为打包了完整的数据库数据，镜像体积会变大，但这是一次性的构建成本，测试时启动速度会快很多，而且不用每次跑初始化脚本。
• 脚本兼容性：如果你的init-db.sh里包含创建数据库、导入数据的逻辑，把RUN里的psql命令换成su postgres -c "/docker-entrypoint-initdb.d/init-db.sh"即可，记得脚本里要使用已经设置好的环境变量（比如$POSTGRES_USER）。
• 测试场景适配：启动容器时不需要绑定任何卷，直接用docker run mydb:latest即可——每次启动都是镜像里预初始化的干净数据库，不会有残留数据影响测试用例。

验证方法： #

构建完成后，启动容器，进入容器执行psql -U test_user -d my_custom_db，就能看到你导入的自定义数据库和数据了，而且重启容器后数据不会消失（除非你删除镜像重新构建），完全符合你的需求。

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