Railway部署Django项目时Docker构建报错：ENV名称不能为空

• 原Django项目在Railway部署正常，添加django-sendgrid-v5包后开发环境功能（含注册邮件）正常
• 通过Railway默认Nixpacks构建部署时，持续触发**“ENV名称不能为空”**的Docker构建错误
• 已确认Railway平台环境变量配置正确，检查了settings.py和.env文件无问题，卸载django-sendgrid-v5后部署仍失败
• 自动生成的Dockerfile第12行存在空白ENV项，但项目由平台自动构建，无法直接修改

1. 排查本地.env文件格式 #

Nixpacks会读取本地.env文件变量并注入Dockerfile，若文件存在空行、格式错误的变量（比如仅含=无变量名），会生成空白ENV项：

• 打开本地.env，删除所有空行
• 确保每个变量遵循KEY=VALUE格式，无单独的=或无名称的变量
• 变量值含特殊字符时用引号包裹（如SENDGRID_API_KEY="abc123!@#"）

2. 清理Railway平台冗余环境变量 #

平台若存在未命名的空环境变量，会被Nixpacks读取导致错误：

• 进入Railway项目的环境变量页面
• 删除所有名称为空的变量项
• 保存后重新触发部署

3. 自定义Nixpacks配置跳过自动.env注入 #

若上述方法无效，在项目根目录创建nixpacks.toml文件，手动指定构建流程：

[phases.setup]
nixPkgs = ["python311", "pip"]
commands = ["pip install -r requirements.txt"]

[phases.build]
commands = ["python manage.py collectstatic --noinput"]

[start]
command = "gunicorn your_project_name.wsgi:application"

注意替换your_project_name为实际Django项目名称

4. 手动编写Dockerfile替代自动构建 #

若Nixpacks自动生成的Dockerfile始终异常，可自定义Dockerfile上传至项目根目录，Railway会优先使用该文件：

FROM python:3.11-slim

WORKDIR /app

COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

COPY . .

RUN python manage.py collectstatic --noinput

ENV PYTHONUNBUFFERED 1

CMD ["gunicorn", "--bind", "0.0.0.0:$PORT", "your_project_name.wsgi:application"]

替换your_project_name为实际项目名称，环境变量通过Railway平台注入，无需在Dockerfile中添加多余ENV项

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