PostgreSQL角色'your_postgres_user'不存在错误排查求助

错误分析 #

你遇到的psycopg2.OperationalError: FATAL: role "your_postgres_user" does not exist错误，说明代码实际尝试使用的数据库用户是占位符your_postgres_user，而非你.env文件中配置的postgres，核心问题是环境变量未正确读取或加载流程有问题。

修复步骤 #

1. 确保所有涉及数据库的文件都加载了.env #

如果使用python-dotenv库加载环境变量，必须在读取环境变量前调用load_dotenv()，且要确保database.py和main.py都执行了这一步：

# 在main.py和database.py的开头添加
from dotenv import load_dotenv
import os

load_dotenv()  # 加载根目录下的.env文件

如果未使用python-dotenv，需确保系统环境变量中POSTGRES_USER的值是postgres，而非占位符。

2. 验证环境变量读取结果 #

在database.py的get_db_config函数中添加临时打印，确认实际读取到的用户值：

def get_db_config():
    user = os.getenv('POSTGRES_USER')
    print(f"当前读取的数据库用户: {user}")  # 运行后查看终端输出
    return {
        'dbname': os.getenv('DB_NAME'),
        'user': user,
        'password': os.getenv('POSTGRES_PASSWORD'),
        'host': os.getenv('DB_HOST'),
        'port': os.getenv('DB_PORT')
    }

• 如果输出是your_postgres_user：说明.env文件未被正确加载，检查文件路径（必须在项目根目录，文件名为.env）、文件格式（键值对无多余空格，如POSTGRES_USER=postgres）。
• 如果输出是postgres：继续下一步排查。

3. 确认PostgreSQL配置匹配 #

• 登录PostgreSQL终端，执行\du确认postgres用户存在且有登录权限；执行\l确认mydatabase数据库已创建。
• 检查PostgreSQL监听端口是否为5432，可通过postgres.conf文件或终端命令netstat -an | grep 5432验证。

4. 临时硬编码测试（快速排查） #

若环境变量读取仍有问题，可临时硬编码数据库配置测试连接：

def get_db_config():
    return {
        'dbname': 'mydatabase',
        'user': 'postgres',
        'password': '',
        'host': 'localhost',
        'port': '5432'
    }

如果能成功连接，说明问题出在环境变量加载流程；若仍报错，检查PostgreSQL服务是否正常运行，或防火墙是否拦截了5432端口。

内容的提问来源于stack exchange，提问作者Zohan - Harry