本文旨在解决heroku上django应用部署时常见的gunicorn配置错误，特别是由于procfile中wsgi模块路径不正确导致的“failed to find attribute 'application'”问题。我们将深入解析正确的gunicorn命令格式，强调项目名称与wsgi文件结构的重要性，并提供最佳实践，确保django应用在heroku上稳定运行。
在Heroku上部署Django应用时，Procfile是定义应用启动命令的关键文件。它告诉Heroku如何运行你的Web进程，而Gunicorn作为WSGI服务器，通常负责托管Django应用。然而，不正确的Gunicorn配置是导致应用崩溃的常见原因，尤其是在指定WSGI模块路径时。
理解Gunicorn与WSGI应用加载机制
Gunicorn通过一个命令来启动，该命令通常指向一个WSGI应用对象。对于Django项目，这个WSGI应用对象通常在你的主项目目录下的wsgi.py文件中定义。例如，如果你的Django项目名为myproject，那么wsgi.py文件通常位于myproject/myproject/wsgi.py，并且其中包含一个名为application的WSGI callable。
Gunicorn的命令格式通常是module_path:application_object。这里的module_path是一个Python模块的路径，Gunicorn会尝试导入这个模块，然后查找其中指定的application_object。
常见错误与问题分析
当你在Procfile中尝试使用类似web: gunicorn SC_BASIS:application -b 127.0.0.1:8000的命令时，可能会遇到以下问题：
Failed to find attribute 'application' in 'SC_BASIS'. 这个错误信息明确指出，Gunicorn尝试在名为SC_BASIS的Python模块中直接寻找一个名为application的属性，但未能找到。这通常是因为SC_BASIS本身并不是包含WSGI application对象的模块。在Django的标准项目中，application对象是在wsgi.py文件中定义的，而wsgi.py文件通常位于你的主项目包内部。正确的做法是指定到包含wsgi.py的模块路径。
绑定到127.0.0.1:8000 在Heroku环境中，应用不应绑定到固定的本地IP地址和端口（如127.0.0.1:8000）。Heroku会通过PORT环境变量动态分配一个端口。Gunicorn默认会监听0.0.0.0:$PORT，因此通常无需在命令中显式指定-b参数。如果指定了127.0.0.1:8000，Gunicorn将只监听本地回环地址，导致Heroku无法访问你的应用。
web: gunicorn SCBASIS.wsgi 虽然这个命令更接近正确答案，但仍可能存在细微差别。SCBASIS.wsgi表示Gunicorn会导入SCBASIS包中的wsgi模块，并默认查找名为application的WSGI callable。如果你的项目结构或包名与SCBASIS不完全匹配，或者wsgi.py不在预期的位置，仍然会失败。
正确的Procfile配置
解决上述问题的关键在于正确指定Gunicorn加载Django WSGI应用模块的路径。假设你的Django项目主目录（包含manage.py和你的主项目包，例如myproject）的名称是project_name。那么，你的wsgi.py文件通常位于project_name/project_name/wsgi.py。
在Procfile中，正确的Gunicorn命令应该是：
web: gunicorn project_name.wsgi --log-file -
解析：
- web:：这是Heroku Procfile的标准格式，表示定义一个Web进程。
- gunicorn：启动Gunicorn WSGI HTTP服务器。
- project_name.wsgi：这是关键部分。它告诉Gunicorn去导入名为project_name的Python包中的wsgi模块。Gunicorn会自动在这个wsgi模块中寻找名为application的WSGI callable。请确保将project_name替换为你的实际Django项目主目录的名称（通常是包含settings.py和wsgi.py的那个目录）。
- --log-file -：这个参数非常重要。它指示Gunicorn将所有的日志输出到标准输出（stdout）。Heroku会自动捕获标准输出和标准错误，并将其显示在应用的日志流中，这对于调试和监控至关重要。
部署最佳实践与注意事项
为了确保Django应用在Heroku上顺利部署，请遵循以下最佳实践：
-
requirements.txt文件 确保你的项目根目录包含一个requirements.txt文件，其中列出了所有Python依赖，包括django和gunicorn。
Django==X.Y.Z gunicorn==A.B.C psycopg2-binary==P.Q.R # 如果使用PostgreSQL whitenoise==S.T.U # 用于静态文件服务
你可以使用pip freeze > requirements.txt来生成此文件。
-
Django settings.py配置
- DEBUG = False: 在生产环境中务必将DEBUG设置为False。
- ALLOWED_HOSTS: 必须包含你的Heroku应用域名，例如 ['.herokuapp.com', 'your-custom-domain.com']。
-
静态文件配置: 配置STATIC_ROOT和STATIC_URL，并使用whitenoise等库来服务静态文件。
import os STATIC_URL = '/static/' STATIC_ROOT = os.path.join(BASE_DIR, 'staticfiles') STATICFILES_DIRS = [ os.path.join(BASE_DIR, 'static'), ] # Whitenoise配置 MIDDLEWARE = [ # ... 'whitenoise.middleware.WhiteNoiseMiddleware', # ... ] STATICFILES_STORAGE = 'whitenoise.storage.CompressedManifestStaticFilesStorage' -
数据库配置: Heroku通常提供PostgreSQL数据库。使用dj-database-url等库可以方便地从环境变量配置数据库。
import dj_database_url DATABASES = { 'default': dj_database_url.config(conn_max_age=600, ssl_require=True) }
-
Procfile示例 在你的项目根目录下创建一个名为Procfile的文件（注意没有文件扩展名），内容如下：
web: gunicorn your_project_name.wsgi --log-file -
请将your_project_name替换为你的实际项目包名。
-
Heroku部署步骤
-
监控日志 部署后，务必检查Heroku日志以排除故障：
heroku logs --tail
这将实时显示你的应用日志，帮助你快速发现并解决问题。
总结
在Heroku上部署Django应用时，Procfile中的Gunicorn命令是核心。通过将Gunicorn指向正确的project_name.wsgi模块路径，并结合--log-file -参数进行日志输出，可以有效避免“Failed to find attribute 'application'”等常见错误。同时，遵循Django settings.py的生产环境配置和Heroku的部署最佳实践，将大大提高部署的成功率和应用的稳定性。
