如何在IBM Cloud部署Django生产服务器？替代runserver及gunicorn排障

我明白你现在的需求——想在IBM Cloud的Cloud Foundry上用生产级的方式跑Django，而不是依赖自带的runserver。你尝试用Gunicorn加Procfile但遇到了启动错误，我来一步步帮你梳理正确的配置和排查思路：

第一步：先把依赖配置做对 #

首先，你的requirements.txt必须明确包含Gunicorn，还有Django和项目的其他依赖。示例配置如下：

django>=4.2
gunicorn>=20.1.0
# 按需添加你的其他依赖，比如psycopg2-binary（如果用PostgreSQL）、django-cors-headers等

本地先执行pip install -r requirements.txt验证依赖安装正常，避免部署时踩坑。

第二步：修正Procfile的配置 #

你之前的Procfile应该是没写完整或者路径有误。正确的格式要注意这几个关键细节：

web: gunicorn --bind 0.0.0.0:$PORT your_project_name.wsgi:application

• $PORT是Cloud Foundry自动分配的端口，必须用这个变量，不能硬编码固定端口
• your_project_name要替换成你实际的Django项目名——就是包含wsgi.py文件的那个文件夹名称
• :application是wsgi模块里的默认应用对象，这个后缀别漏了

第三步：设置生产环境必需的Django变量 #

生产环境下一定要关闭调试模式、配置安全密钥和允许访问的域名：

• DEBUG=False：禁用调试模式，避免泄露敏感信息
• SECRET_KEY：生成一个安全的随机密钥（别用开发环境的测试密钥）
• ALLOWED_HOSTS：添加IBM Cloud分配给你的应用域名，比如your-app-name.mybluemix.net，测试阶段可以临时用*，但生产环境务必指定具体域名

你可以通过IBM Cloud CLI直接设置这些环境变量：

ibmcloud cf set-env your-app-name DEBUG False
ibmcloud cf set-env your-app-name SECRET_KEY "your-secure-random-key-here"
ibmcloud cf set-env your-app-name ALLOWED_HOSTS "your-app-name.mybluemix.net"

第四步：部署到Cloud Foundry #

确保你已经登录IBM Cloud CLI，进入项目根目录后执行部署命令：

ibmcloud cf push your-app-name

如果部署后还是启动失败，用下面的命令查看详细日志定位问题：

ibmcloud cf logs your-app-name --recent

针对Gunicorn启动失败的常见排查点 #

• 路径错误：检查your_project_name.wsgi是否匹配实际项目结构。比如你的项目是my_django_app/my_django_app/wsgi.py，那应该写my_django_app.wsgi:application
• 依赖缺失：如果日志提示找不到Gunicorn，说明requirements.txt没包含或者部署时依赖安装失败。可以用ibmcloud cf ssh your-app-name进入容器，查看site-packages目录确认Gunicorn是否存在
• 端口问题：必须用$PORT变量，Cloud Foundry会自动完成端口映射，硬编码端口必然失败
• 权限问题：一般Cloud Foundry会自动处理文件权限，但如果是自定义构建的代码，要确保wsgi.py和项目文件有可读权限

如果之后你想进阶用Nginx做反向代理，Cloud Foundry里可以通过多构建pack或者自定义Docker镜像实现——把Gunicorn和Nginx打包成镜像，上传到IBM Cloud容器注册表后再部署。不过对于大多数Django应用来说，Gunicorn本身已经是足够稳定的生产级WSGI服务器，完全能满足需求。

内容的提问来源于stack exchange，提问作者María Victoria