能否创建含初始化数据的Postgres Docker镜像供开发者测试？

完全可以创建包含预填充测试数据的Postgres Docker镜像，这样你的团队成员只需要拉取镜像、启动容器，就能直接用带数据的数据库做测试，省去手动跑脚本的麻烦。下面是一套完整的实现步骤：

步骤1：准备初始化SQL脚本 #

把你的建表语句、插入数据的SQL整理成一个（或多个）脚本文件，比如命名为init.sql。举个简单例子：

-- 创建测试表
CREATE TABLE IF NOT EXISTS users (
    id SERIAL PRIMARY KEY,
    username VARCHAR(50) NOT NULL,
    email VARCHAR(100) NOT NULL
);

-- 插入测试数据
INSERT INTO users (username, email) VALUES
('alice', 'alice@test.com'),
('bob', 'bob@test.com');

步骤2：编写Dockerfile #

基于官方Postgres镜像构建自定义镜像，关键是把你的SQL脚本放到容器的/docker-entrypoint-initdb.d/目录——官方Postgres镜像会在第一次初始化数据库时自动执行这个目录下的.sql或.sh文件。

示例Dockerfile：

# 指定基础镜像，建议用具体版本保证稳定性
FROM postgres:15-alpine

# 复制初始化脚本到容器的自动执行目录
COPY init.sql /docker-entrypoint-initdb.d/

# 可选：预设数据库名、用户名、密码，开发者启动时也可以用环境变量覆盖
ENV POSTGRES_DB=test_db
ENV POSTGRES_USER=dev_user
ENV POSTGRES_PASSWORD=dev_pass

步骤3：构建自定义镜像 #

在Dockerfile和init.sql所在的目录下，执行构建命令：

docker build -t my-team-test-postgres .

这里的my-team-test-postgres是你给镜像起的名字，可以按需修改。

步骤4：测试运行镜像 #

启动容器验证数据是否正确加载：

docker run -d -p 5432:5432 my-team-test-postgres

等容器启动完成后，用Postgres客户端连接localhost:5432，就能看到users表和里面的测试数据了。

几个关键注意事项 #

• 脚本执行时机：只有当容器第一次启动，且数据目录（默认是/var/lib/postgresql/data）为空时，初始化脚本才会执行。如果开发者挂载了自己的数据卷，脚本不会重复运行，这点要提前告知团队成员。
• 镜像体积：如果测试数据量很大，镜像会随之变大，这种情况更适合用数据卷挂载外部数据，而不是把数据打包进镜像。小数据集打包进镜像完全没问题。
• 多脚本顺序：如果有多个初始化脚本，可以给文件名加数字前缀（比如01-create-tables.sql、02-insert-data.sql），官方镜像会按文件名的字典序执行脚本。
• 版本兼容性：尽量指定具体的Postgres版本（比如postgres:15-alpine），避免后续官方镜像更新导致语法或行为不兼容。

你之前没找到案例可能是搜索关键词的问题，试试用“postgres docker pre-populated data image”这类关键词搜索，能找到很多类似的实践方案。

内容的提问来源于stack exchange，提问作者Sredny M Casanova