Plandex项目Docker Compose部署中的PostgreSQL用户认证问题解析

在使用Docker Compose部署Plandex项目时，开发者可能会遇到PostgreSQL用户认证失败的问题。本文将从技术角度深入分析该问题的成因，并提供完整的解决方案。

问题现象分析

当运行Docker Compose时，系统会输出以下关键错误信息：

1. 数据库角色不存在："Role 'user' does not exist"
2. 密码认证失败："password authentication failed for user 'user'"
3. 系统检测到已有数据库目录："Database directory appears to contain a database"

这些现象表明PostgreSQL容器未能正确初始化用户账户，主要原因可能有二：

• 使用了已存在的PostgreSQL数据目录
• 首次初始化过程被意外中断

根本原因

PostgreSQL容器在首次启动时会执行初始化脚本，创建配置文件中指定的用户和数据库。但当检测到已有数据目录时（通过PGDATA_DIR环境变量指定），容器会跳过初始化过程直接启动服务，导致.env文件中配置的用户凭证未被创建。

解决方案

全新部署场景

1. 停止所有运行中的容器
2. 删除本地数据目录（默认位于./datadir）
3. 重新运行docker-compose up

已有数据目录场景

如需保留现有数据，需要手动创建用户：

1. 进入PostgreSQL容器：

   docker exec -it plandex-postgres-1 psql -U postgres
   

2. 执行SQL创建用户：

   CREATE USER user WITH PASSWORD 'password';
   CREATE DATABASE plandex;
   GRANT ALL PRIVILEGES ON DATABASE plandex TO user;
   

平台兼容性说明

日志中出现的平台不匹配警告（linux/amd64 vs linux/arm64/v8）表明在ARM架构设备上运行x86镜像。虽然这不直接影响认证问题，但建议在docker-compose.yml中显式指定平台：

services:
  postgres:
    platform: linux/amd64

最佳实践建议

1. 始终确保.env文件与docker-compose配置同步
2. 开发环境中可设置PIN2LOG=true方便调试
3. 生产环境建议使用更复杂的密码组合
4. 考虑使用docker volume替代本地目录挂载

通过以上步骤，开发者可以彻底解决Plandex项目部署中的PostgreSQL用户认证问题，确保服务正常启动。