MacOS下Docker部署PostgreSQL连接报错role "username"不存在如何解决

问题根因 #

你当前遇到的role "username" does not exist报错核心是两个配置冲突/遗漏：

1. 你本地也安装了PostgreSQL服务，直接执行psql maadbsql默认连接的是本地5432端口的PostgreSQL实例，而非Docker映射到5433端口的容器内实例，你在本地实例中查到的用户信息对容器内实例无效。
2. 你没有为Docker版PostgreSQL配置初始化参数，容器首次启动时默认仅会创建名为postgres的默认数据库、名为postgres的默认用户，不存在你连接配置中指定的maadbsql数据库，也不存在你本地系统对应的username用户。

解决步骤 #

1. 修正环境变量配置
   修改你的postgres.env文件，补充数据库名、用户名的初始化参数：

POSTGRES_HOST_AUTH_METHOD=trust
# 配置初始化默认数据库名，和你连接参数中的database对应
POSTGRES_DB=maadbsql
# 配置初始化默认用户名，和报错中的username对应
POSTGRES_USER=username
# 可选：配置对应密码，开了trust认证可以不填，建议补充
POSTGRES_PASSWORD=your_password

2. 清理旧初始化数据重启服务
   之前的容器已经完成了初始化，旧配置不会自动生效，需要销毁关联存储卷后重启：

# 停止服务并删除关联的存储卷，清除旧的初始化数据
docker-compose down -v
# 用新配置重新启动服务
docker-compose up -d

3. 补充数据库连接参数
   在你的连接配置文件中补充user字段，和你设置的POSTGRES_USER对应即可：

[postgresql]
host=localhost
port=5433
database=maadbsql
user=username
# 如果设置了密码补充下面这行
# password=your_password

4. 验证配置生效
   执行以下命令验证容器内的数据库和用户已正常创建：

psql -h localhost -p 5433 -U username maadbsql

如果可以正常进入数据库命令行，再运行Python代码即可正常连接。

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