Docker Compose更新PostgreSQL后出现目录权限错误的排查求助

核心原因 #

你遇到的权限问题主要来自两个关键点：

• 容器用户权限不匹配：PostgreSQL容器默认以postgres用户（UID=999，GID=999）运行，你把本地pgdata目录改成root:root权限后，容器内的postgres用户完全没有读写该目录的权限，自然无法创建所需的目录结构。
• PostgreSQL 18镜像的破坏性变更：你之前用的是17.6版本，而latest标签现在指向了PostgreSQL 18的官方镜像。18版本移除了预先创建/var/lib/postgresql/data目录的逻辑，启动时会尝试自动创建该目录，但由于挂载的子目录（/var/lib/postgresql/data/pgdata）的父目录权限不兼容，直接触发了权限拒绝错误。

解决方案 #

方案1：修复本地挂载目录权限（推荐）

直接将本地pgdata目录的权限修改为容器内postgres用户对应的UID/GID：

sudo chown -R 999:999 ./pgdata

修改完成后重启容器：

docker compose down && docker compose up -d

方案2：锁定PostgreSQL版本（避免意外升级）

如果你暂时不想升级到18版本，可以把镜像指定为之前的稳定版本或17系列：
修改docker-compose.yaml中的镜像字段：

image: 'postgres:17.6-1.pgdg13+1'
# 或者锁定到17系列：image: 'postgres:17'

之后重新拉取镜像并启动容器：

docker compose pull postgres && docker compose up -d

方案3：临时以root用户运行容器（不推荐生产环境）

在docker-compose.yaml的postgres服务中添加user: root配置，让容器以root用户启动（会带来安全风险，仅用于临时测试）：

services:
  postgres:
    # 其他配置不变
    user: root

验证方法 #

执行以下命令查看容器日志，确认错误是否消失：

docker compose logs general_postgres

如果日志显示database system is ready to accept connections，说明问题已解决。

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