Docker构建Postgres14容器时initdb未生成数据目录默认文件

刚接触Docker，尝试基于Alpine Linux构建Postgres 14容器，当前的Dockerfile和docker-compose.yml如下：

Dockerfile #

FROM alpine:3.15.5
EXPOSE 5432

# update repo, install postgres 14
RUN apk update
RUN apk add gcc make
RUN apk add postgresql14 postgis

# data dir
RUN mkdir /var/lib/postgresql/data
RUN chmod 0700 /var/lib/postgresql/data
RUN chown postgres:postgres /var/lib/postgresql/data
VOLUME /var/lib/postgresql/data

# create db cluster as postgres user
USER postgres:postgres
RUN initdb -D /var/lib/postgresql/data

# temp
ENTRYPOINT [ "top" ]

docker-compose.yml #

version: '3.9'

services:
  postgres:
    build: .
    ports:
      - "5432:5432"
    volumes:
      - ./postgres:/var/lib/postgresql/data

执行docker-compose up --build构建并运行容器时，initdb命令执行无报错，但/var/lib/postgresql/data目录中并未生成Postgres默认配置文件和数据库文件。进入运行中的容器手动执行initdb -D /var/lib/postgresql/data却能正常生成文件，求排查问题。

• 核心冲突：镜像构建阶段的VOLUME与运行时本地挂载卷的覆盖
  在Dockerfile中声明VOLUME /var/lib/postgresql/data后，构建阶段RUN initdb生成的文件会被写入镜像内置的匿名卷中。当通过docker-compose挂载本地目录./postgres到该路径时，运行时容器会用本地挂载的空目录完全覆盖镜像中该路径的内容，导致构建阶段生成的初始化文件无法被看到。

• 具体修复步骤

  1. 移除Dockerfile中的VOLUME声明：构建阶段无需提前声明卷，运行时通过docker-compose挂载即可，避免构建阶段的初始化文件被隔离到匿名卷中。
  2. 将初始化逻辑移至运行时执行：因为本地挂载目录首次启动是空的，需要在容器启动时自动判断是否需要初始化数据库。可以通过自定义启动脚本实现：
     • 修改后的Dockerfile：

       FROM alpine:3.15.5
       EXPOSE 5432
       
       # 合并安装命令，减少镜像层
       RUN apk update && apk add --no-cache gcc make postgresql14 postgis
       
       # 初始化数据目录权限
       RUN mkdir /var/lib/postgresql/data && \
           chmod 0700 /var/lib/postgresql/data && \
           chown postgres:postgres /var/lib/postgresql/data
       
       USER postgres:postgres
       
       # 复制启动脚本
       COPY entrypoint.sh /entrypoint.sh
       RUN chmod +x /entrypoint.sh
       
       ENTRYPOINT ["/entrypoint.sh"]
       

     • 创建entrypoint.sh脚本（与Dockerfile同目录）：

       #!/bin/sh
       set -e
       
       # 通过PG_VERSION文件判断数据库是否已初始化
       if [ ! -f /var/lib/postgresql/data/PG_VERSION ]; then
           initdb -D /var/lib/postgresql/data
       fi
       
       # 启动Postgres服务
       exec postgres -D /var/lib/postgresql/data
       

  3. 保留docker-compose.yml的挂载配置：首次启动时，脚本会自动初始化本地目录，后续启动则直接复用已有数据。

• 补充说明
  构建阶段的RUN命令是在镜像构建时执行的，生成的文件属于镜像层，但如果路径被标记为VOLUME，这些文件会被复制到匿名卷中。运行时挂载本地卷会直接替换该路径的内容，所以看不到构建阶段的文件。而手动进入容器执行initdb是直接写入当前挂载的本地目录，因此能正常生成文件。

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