使用Cookiecutter创建Docker+DRF应用时PostgreSQL认证失败求助

问题根源 #

Cookiecutter生成DRF+Docker项目时，会自动生成随机的PostgreSQL用户名、密码并写入项目根目录的.env文件。如果之前运行过容器但没彻底清理数据卷，旧容器里的PostgreSQL实例已经创建了一套用户数据，和当前.env里的新随机值不匹配，就会触发这个认证错误。

分步解决 #

1. 彻底清理旧容器与数据卷
   运行以下命令停止所有关联容器，并删除保存PostgreSQL数据的卷（这会清除旧的用户和数据库数据，是解决不匹配问题的关键）：

   docker-compose -f local.yml down -v
   

2. 验证配置一致性
   打开项目根目录的.env文件，确认POSTGRES_USER、POSTGRES_PASSWORD、POSTGRES_DB三个变量存在，且Django的本地配置文件（config/settings/local.py）中的数据库配置是读取这些环境变量的，示例如下：

   DATABASES = {
       "default": {
           "ENGINE": "django.db.backends.postgresql",
           "NAME": env("POSTGRES_DB"),
           "USER": env("POSTGRES_USER"),
           "PASSWORD": env("POSTGRES_PASSWORD"),
           "HOST": "postgres",
           "PORT": 5432,
       }
   }
   

   不要手动修改.env里的随机值，保持Cookiecutter生成的默认配置即可。

3. 重新启动服务
   执行启动命令，此时PostgreSQL容器会根据当前.env的配置重新创建对应的数据库角色和实例：

   docker-compose -f local.yml up
   

新手注意事项 #

• 每次修改.env里的DB配置后，必须清理数据卷再重启，否则旧的PostgreSQL数据会残留导致不匹配。
• 若后续再次出现类似错误，优先执行docker-compose -f local.yml down -v清理数据卷，再重新启动。

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