使用 Heroku 的 Django 部署中缺少静态文件清单条目

Posted 2023-02-24

【中文标题】使用 Heroku 的 Django 部署中缺少静态文件清单条目

【英文标题】：Missing staticfiles manifest entry in Django deployment using Heroku

【发布时间】：2017-12-29 10:30:17

【问题描述】：

我正在尝试将我的 webapp 部署到 heroku。我正在使用 Django，以下是我的大部分 settings.py 文件：

"""
Django settings for blog project on Heroku. For more info, see:
https://github.com/heroku/heroku-django-template

For more information on this file, see
https://docs.djangoproject.com/en/1.9/topics/settings/

For the full list of settings and their values, see
https://docs.djangoproject.com/en/1.9/ref/settings/
"""

import os
import dj_database_url
import raven

# Build paths inside the project like this: os.path.join(BASE_DIR, ...)
BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
PROJECT_ROOT = os.path.dirname(os.path.abspath(__file__))

try:
    from .local_settings import *
except ImportError:
    pass

# Application definition

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    # Disable Django's own staticfiles handling in favour of WhiteNoise, for
    # greater consistency between gunicorn and `./manage.py runserver`. See:
    # http://whitenoise.evans.io/en/stable/django.html#using-whitenoise-in-development
    'whitenoise.runserver_nostatic',
    'django.contrib.staticfiles',
    'blogapp',
    'homeapp',
    'nimfksapp',
    'omniclipapp',

    #Heroku Sentry
    'raven.contrib.django.raven_compat',
]

MIDDLEWARE_CLASSES = [
    'django.middleware.security.SecurityMiddleware',
    'whitenoise.middleware.WhiteNoiseMiddleware',
    'django.contrib.sessions.middleware.SessionMiddleware',
    'django.middleware.common.CommonMiddleware',
    'django.middleware.csrf.CsrfViewMiddleware',
    'django.contrib.auth.middleware.AuthenticationMiddleware',
    'django.contrib.auth.middleware.SessionAuthenticationMiddleware',
    'django.contrib.messages.middleware.MessageMiddleware',
    'django.middleware.clickjacking.XFrameOptionsMiddleware',
]

ROOT_URLCONF = 'blog.urls'
   
WSGI_APPLICATION = 'blog.wsgi.application'
    
# Static files (CSS, javascript, Images)
# https://docs.djangoproject.com/en/1.9/howto/static-files/

STATIC_ROOT = os.path.join(BASE_DIR, 'live-static', 'static-root')
STATIC_URL = '/static/'

# Extra places for collectstatic to find static files.
STATICFILES_DIRS = [
    os.path.join(BASE_DIR, 'static'),
]

MEDIA_URL = "/media/"

MEDIA_ROOT = os.path.join(BASE_DIR, "live-static", "media-root")

# Simplified static file serving.
# https://warehouse.python.org/project/whitenoise/
STATICFILES_STORAGE = 'whitenoise.storage.CompressedManifestStaticFilesStorage'

在本地运行collectstatic 时，静态文件会被很好地收集并在网页上提供。当我将应用程序部署到 heroku（它会自动为我运行 collectstatic 命令）时，它会抛出“内部服务器错误（500）”。我遵循了类似 SO 页面上的建议，并通过 heroku 向应用程序添加了哨兵，并得到了更清晰的错误消息：

ValueError/nimfks/errorMissing staticfiles manifest entry for...

我尝试更改（和删除）STATICFILES_STORAGE，但没有成功。删除它让我克服了错误，但尝试显示实际的静态文件（在本例中为图像）不起作用，即它没有加载。

我还尝试将静态设置更改为使用PROJECT_ROOT 而不是BASE_DIR 以及许多不同的配置，但所有这些都不起作用。

我在这里遗漏了什么吗？我似乎无法在 SO 上提出的类似问题中找到答案。

编辑

回答：

虽然很尴尬，但我想继续这样做，因为它可能会帮助其他人在这方面苦苦挣扎。我的问题是我在我的 html 文件中使用了.PNG，而不是真正的文件扩展名.png。没有意识到这是区分大小写的。这个问题的真正解决方案本质上只是让一个哨兵运行来捕获这些类型的错误（参见sentry docs）。这是我在 settings.py 文件中的静态设置的最终版本：

import os
import dj_database_url
import raven

# Build paths inside the project like this: os.path.join(BASE_DIR, ...)
BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
PROJECT_ROOT = os.path.dirname(os.path.abspath(__file__))

    MIDDLEWARE_CLASSES = [
    'django.middleware.security.SecurityMiddleware',
    'whitenoise.middleware.WhiteNoiseMiddleware',
    'django.contrib.sessions.middleware.SessionMiddleware',
    'django.middleware.common.CommonMiddleware',
    'django.middleware.csrf.CsrfViewMiddleware',
    'django.contrib.auth.middleware.AuthenticationMiddleware',
    'django.contrib.auth.middleware.SessionAuthenticationMiddleware',
    'django.contrib.messages.middleware.MessageMiddleware',
    'django.middleware.clickjacking.XFrameOptionsMiddleware',
]

WSGI_APPLICATION = 'blog.wsgi.application'

STATIC_ROOT = os.path.join(PROJECT_ROOT, 'staticfiles')
STATIC_URL = '/static/'

# Extra places for collectstatic to find static files.
STATICFILES_DIRS = [
    os.path.join(PROJECT_ROOT, 'static'),
]

# Simplified static file serving.
# https://warehouse.python.org/project/whitenoise/
STATICFILES_STORAGE = 'whitenoise.storage.CompressedManifestStaticFilesStorage'

【参考方案1】：

尝试评论该行 'django.contrib.staticfiles', 在 INSTALLED_APPS 内