部署Django至Railway触发ImproperlyConfigured错误求助

核心问题定位 #

你遇到的ImproperlyConfigured错误，虽提示缺少ENGINE值，但实际大概率是数据库配置键名错误及Railway环境变量加载异常导致的。

分步解决方案 #

1. 修正DATABASES配置的键名错误 #

Django数据库配置中，用户名字段的正确键为USER，而非你写的USERNAME。这个错误会导致Django无法正确解析数据库配置，进而触发ENGINE配置异常的报错。修改后的配置如下：

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'HOST': os.environ.get('PGHOST'),
        'NAME': os.environ.get('PGDATABASE'),  
        'USER': os.environ.get('PGUSER'),  # 替换原USERNAME为USER
        'PASSWORD': os.environ.get('PGPASSWORD'),
        'PORT': os.environ.get('PGPORT')
    }
}

2. 确认Railway上已添加PostgreSQL服务 #

在Railway项目控制台中，必须先添加PostgreSQL官方插件：

• 点击Add Service，选择PostgreSQL
• 服务创建完成后，Railway会自动为Django服务注入PGHOST、PGDATABASE、PGUSER、PGPASSWORD、PGPORT这些环境变量

3. 补全生产环境依赖 #

确保requirements.txt中包含PostgreSQL适配库，添加以下内容：

psycopg2-binary>=2.9.0

（psycopg2-binary无需编译依赖，更适合Railway的部署场景）

4. 验证环境变量加载状态 #

可在settings.py中添加临时调试代码（部署后可删除），确认环境变量是否正常注入：

import os
# 打印环境变量用于调试
print("PGHOST:", os.environ.get('PGHOST'))
print("PGDATABASE:", os.environ.get('PGDATABASE'))

查看Railway部署日志，若变量为空，需检查PostgreSQL服务与Django服务的关联是否正确。

5. 排查生产环境配置覆盖问题 #

如果你有settings/production.py这类生产环境专属配置文件，确认其中没有重新定义DATABASES而覆盖了上述配置。

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