Docker部署Django到Heroku时无法修改Dyno进程命令问题

核心原因 #

Heroku通过Docker镜像部署应用时，不会读取Procfile中的启动命令，而是优先使用Dockerfile里定义的CMD或ENTRYPOINT指令。你的Dockerfile没有指定启动命令，Heroku会默认使用基础镜像python:3的默认命令python3，导致进程启动后无有效任务执行，最终崩溃。

具体解决步骤 #

1. 修改Dockerfile，添加启动命令
   在Dockerfile的末尾添加CMD指令，指定gunicorn的启动命令（注意使用Heroku动态分配的$PORT环境变量，不能硬写8000）：

   FROM python:3
   
   ENV PYTHONDONTWRITEBYTECODE=1
   ENV PYTHONUNBUFFERED=1
   
   WORKDIR /app
   
   COPY requirements.txt /app/
   
   RUN pip install -r requirements.txt
   
   COPY . /app/
   
   # 添加启动命令
   CMD ["gunicorn", "kereell.wsgi", "--bind", "0.0.0.0:$PORT"]
   

2. 适配Heroku数据库环境（可选但推荐）
   Heroku提供Postgres服务时会自动生成DATABASE_URL环境变量，建议在Django的settings.py中直接读取该变量，替代拆分的数据库配置：

   • 先在requirements.txt中添加dj-database-url：

     Django
     psycopg2
     gunicorn
     dj-database-url
     

   • 修改settings.py中的数据库配置：

     import os
     import dj_database_url
     
     # ... 其他配置 ...
     
     DATABASES = {
         'default': dj_database_url.config(default=os.environ.get('DATABASE_URL'))
     }
     

3. 设置Heroku环境变量
   通过Heroku CLI或控制台设置必要的环境变量（如SECRET_KEY、DEBUG等）：

   heroku config:set DEBUG=False SECRET_KEY=your_actual_secret_key
   

4. 重新推送Docker镜像
   执行以下命令重新构建并发布镜像：

   heroku container:push web
   heroku container:release web
   

5. 排查日志（若仍崩溃）
   如果进程还是崩溃，通过日志查看具体错误：

   heroku logs --tail
   

   常见问题包括：wsgi模块路径错误、依赖缺失、数据库连接失败等，可根据日志信息针对性修复。

额外说明 #

• docker-compose.yml仅用于本地开发环境，Heroku部署Docker时不会读取该文件，无需修改其中的command配置。
• Procfile在Docker部署场景下无效，可直接删除或保留（不会影响部署）。

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