部署Django应用到GCP App Engine（Gunicorn）时遇502 Bad Gateway错误

核心原因 #

日志中Worker (pid:17) was sent SIGKILL! Perhaps out of memory?明确指向：App Engine实例内存不足，导致Gunicorn worker进程被系统强制终止，进而触发Nginx返回502错误。

解决方案 #

1. 升级App Engine实例资源 #

默认的F1实例仅提供256MB内存，无法满足Django+Gunicorn的运行需求，需在app.yaml中指定更高配置的实例：

runtime: python311
service: forecasting-django-app
# 升级到F2实例（512MB内存），或根据需求选择更高规格（如F4、B1等）
instance_class: F2
# 也可自定义资源配置（适用于灵活环境）
# resources:
#   cpu: 1
#   memory_gb: 1.5
#   disk_size_gb: 10
entrypoint: gunicorn -b :$PORT sales_forecasting.wsgi:application

handlers:
- url: /static/
  static_dir: staticfiles/
- url: /.*
  script: auto

2. 优化Gunicorn Worker配置 #

调整worker数量和线程数，避免内存过度占用：

• 减少worker数量：根据实例内存，将worker数设为1或2（默认公式2*CPU核数+1在小内存实例上会导致内存过载）
• 启用线程模式：用线程替代多进程，降低内存开销
• 添加worker重启机制：防止内存泄漏累积

修改后的entrypoint示例：

entrypoint: gunicorn -b :$PORT --workers=1 --threads=4 --max-requests=1000 sales_forecasting.wsgi:application

3. 排查应用内存占用问题 #

• 本地使用memory_profiler工具定位高内存代码：比如检查results.json是否被完整加载到内存未释放，或数据库查询是否返回了过量数据
• 确保静态文件已通过python manage.py collectstatic收集到staticfiles目录，且App Engine的静态文件路由配置正确，避免应用进程处理静态请求消耗内存

4. 精简依赖包 #

清理requirements.txt，移除本地测试用的依赖（如Waitress），只保留生产环境必需的包，减少内存占用。

验证步骤 #

1. 修改配置后，重新部署应用：gcloud app deploy
2. 查看GCP日志，确认是否还存在SIGKILL错误
3. 访问应用URL，检查502错误是否消失

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