Django搭配docker-compose运行时报PostgreSQL用户密码认证失败如何解决

你遇到的password authentication failed for user "usertodoproject"报错，结合给出的配置，按以下优先级排查即可解决：

• 首先修复docker-compose.yaml的缩进错误
  你提供的配置中db服务下的environment字段对应的环境变量没有正确缩进，YAML对缩进要求严格，未缩进的环境变量不会被PostgreSQL容器识别，导致账号密码配置不生效。修正后的db服务配置如下：

db:
  image: postgres
  environment:
    - POSTGRES_DB=todoproject
    - POSTGRES_USER=usertodoproject
    - POSTGRES_PASSWORD=todoprojectpass
  ports:
    - "5432:5432"

注意：environment和ports下的列表项需要缩进2个空格，和父字段保持层级关系

• 清理旧的PostgreSQL容器数据卷
  PostgreSQL容器仅在第一次启动且数据卷为空时，才会读取环境变量初始化账号密码。如果之前启动过db容器，旧的已初始化的数据卷会被复用，新配置不会生效。执行以下命令清理残留数据：

docker-compose down -v

注意：-v参数会删除容器关联的卷，如有需要保留的旧数据请提前备份

• 排查本地端口冲突问题
  如果你的本地主机也运行了PostgreSQL服务占用了5432端口，你之前执行的ALTER USER todouser WITH PASSWORD 'todo';命令修改的是本地PostgreSQL的账号，而非Docker容器内的账号，完全不会生效。可修改docker-compose的端口映射为- "5433:5432"避免冲突，后续连接容器内的数据库时使用5433端口即可。

• 可选：添加启动等待逻辑
  depends_on仅保证db容器先启动，不保证PostgreSQL服务完全初始化完成。如果执行完以上步骤还有偶发连接报错，可以修改web服务的启动命令，等数据库端口可访问后再启动Django服务：

command: bash -c "wait-for-it db:5432 -- python manage.py runserver 0.0.0.0:8000"

以上操作完成后执行docker-compose up --build重新启动服务即可。

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