Django项目使用环境变量连接AWS RDS Postgres实例配置问题

首先你现有配置存在两个核心问题：

1. 语法错误：DATABASES字典未正确闭合，内部直接写DATABASES['default']赋值属于无效语法，会导致配置解析异常
2. 重复配置逻辑冲突：同时手动配置数据库参数、又用dj_database_url覆盖配置，多余且容易出现变量覆盖问题

正确配置方案（完全基于环境变量，无硬编码） #

方案一：仅使用DATABASE_URL环境变量（更简洁，推荐） #

dj_database_url会自动解析连接串内的用户名、密码、主机、端口、库名，无需拆分多个环境变量：

import os
import dj_database_url

# 其余项目配置省略...

DATABASES = {
    'default': dj_database_url.config(
        default=os.environ.get('DATABASE_URL'),
        conn_max_age=600,
        engine='django.db.backends.postgresql'
    )
}

方案二：使用拆分的独立环境变量 #

如果你不想用统一连接串，要保留DB_NAME、DB_USERNAME等单独环境变量，可使用以下配置：

import os

# 其余项目配置省略...

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': os.environ.get('DB_NAME'),
        'USER': os.environ.get('DB_USERNAME'),
        'PASSWORD': os.environ.get('DB_PASSWORD'),
        'HOST': os.environ.get('DB_HOST'),
        'PORT': os.environ.get('DB_PORT', 5432),
    }
}

密码认证失败排查步骤 #

• 先验证环境变量有效性：启动Django前在终端执行echo $DATABASE_URL（Linux/macOS）或echo %DATABASE_URL%（Windows cmd），确认输出的连接串中用户名、密码和AWS RDS实例配置的完全一致，若密码包含@、:、/等特殊字符，需要先做URL编码后再写入环境变量（比如@替换为%40，:替换为%3A）
• 验证RDS访问权限：确认RDS实例的安全组已放开你本地公网IP的5432端口入站规则，且RDS实例已开启公网访问（本地连接场景下）
• 直接用数据库工具验证连接：使用psql postgres://<user>:<password>@<host>:5432/cust_manage命令行测试连接，如果同样报密码错误，说明是环境变量内的账号密码配置错误，和Django配置无关
• 调试Django配置解析结果：可在settings.py中临时加一行print(DATABASES['default'])（调试完成后删除），确认解析出来的账号、密码字段和你配置的一致，没有被其他逻辑覆盖

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