Docker挂载卷后PostgreSQL服务器认证失败求助

问题原因 #

PostgreSQL官方镜像（alpine版本）中，PostgreSQL进程以postgres用户运行，该用户的UID为999。当你将Windows本地目录挂载到容器内的/var/lib/postgresql/data时，容器内的postgres用户没有权限读写该目录，导致数据库初始化流程异常：要么无法创建指定的dev用户及密码，要么读取到目录中残留的旧数据库配置，最终引发密码验证失败。

解决方案 #

方案1：使用Docker管理的Volume（推荐） #

Docker管理的Volume会自动处理容器内的权限问题，无需手动配置。修改启动命令如下：

docker run --name to-pg-container -d -p 5000:5432 -e POSTGRES_USER=dev -e POSTGRES_PASSWORD=123 -e POSTGRES_DB=pg_db -v pg_data_volume:/var/lib/postgresql/data postgres:alpine

• pg_data_volume是Docker自动创建的管理型Volume，权限由Docker自动适配容器内的postgres用户。
• 若需查看该Volume的实际存储位置，执行命令：docker volume inspect pg_data_volume

方案2：修复本地目录挂载的权限问题（Windows环境） #

1. 清空残留数据：先删除D:\pg_data\data目录下的所有内容，避免旧数据库配置干扰。
2. 确保磁盘共享：打开Docker Desktop设置，进入Resources > File Sharing，勾选D盘，允许Docker访问该磁盘。
3. 使用WSL2路径挂载（如果Docker基于WSL2后端）：
   改用WSL2的路径格式挂载目录，而非Windows原生路径，命令如下：

   docker run --name to-pg-container -d -p 5000:5432 -e POSTGRES_USER=dev -e POSTGRES_PASSWORD=123 -e POSTGRES_DB=pg_db -v /mnt/d/pg_data/data:/var/lib/postgresql/data postgres:alpine
   

   这种方式下，WSL2会自动处理权限映射，让容器内的postgres用户能正常读写目录。

验证步骤 #

容器启动后，执行以下命令测试连接：

psql -h localhost -p 5000 -U dev pg_db

输入密码123即可正常连接。

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