Django连接ElephantSQL报Peer authentication failed错误排查求助

配置层面的直接错误 #

• Django的PostgreSQL连接配置键名有严格的大小写要求，原配置中将HOST写为大写开头的Host，框架无法识别该配置项
• 框架无法获取远程主机地址时，会默认回退到本地Unix域套接字连接本机PostgreSQL服务，直接触发Peer authentication failed报错——本质是本地连接走peer认证规则时的权限不匹配，和远程ElephantSQL实例无关联

操作层面的认知偏差 #

• 所有本地pg_hba.conf修改、本地PG服务重启、本地PostgreSQL重装/删除目录的操作，仅作用于本机安装的本地PG服务
• ElephantSQL是托管在远端服务器上的独立PostgreSQL实例，其自身的连接校验规则、用户权限由平台方统一管控，本地配置的任何调整都不会影响远端实例的连接结果，因此所有调整本地配置的操作对问题解决无帮助

权限认知错误 #

• ElephantSQL在实例创建完成时，会自动为对应账号完成数据库、用户、密码的全流程初始化，用户无权限、也不需要在实例上执行新建数据库类操作
• 执行createdb命令时尝试连接PostgreSQL默认的template1模板库，ElephantSQL的安全规则默认不开放普通用户对该库的访问权限，因此会返回no pg_hba.conf entry报错——该报错指向的是远端实例的访问规则，并非本地pg_hba配置

可直接复用的正确配置 #

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': 'ElephantSQL提供的数据库名',
        'USER': 'ElephantSQL提供的用户名',
        'PASSWORD': 'ElephantSQL提供的数据库密码',
        'HOST': 'ziggy.db.elephantsql.com',
        'PORT': '5432',
        'OPTIONS': {
            # 匹配ElephantSQL强制SSL连接的要求
            'sslmode': 'require'
        }
    }
}

补充注意事项 #

• 现代Django版本无需指定django.db.backends.postgresql_psycopg2作为引擎值，使用django.db.backends.postgresql即可，框架会自动匹配已安装的psycopg驱动
• 配置修改完成后无需操作本地PostgreSQL服务，直接执行python manage.py makemigrations即可正常连接远端数据库

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