Django Debug关闭后仅index.html报500错误，其余模板正常求助

故障现象 #

• 加载index.html时返回500错误
• 仅当DEBUG = False时触发，DEBUG=True模式下无异常
• 故障仅针对index.html这一个模板，其余所有模板均可正常渲染

已完成排查操作 #

• 核对whitenoise配置
• 排查favicon.ico相关报错
• 核对所有路由配置，未发现异常

相关配置代码 #

settings.py 核心配置 #

DEBUG = False
ALLOWED_HOSTS = ['vilytic.herokuapp.com', '127.0.0.1']

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'rest_framework',
    'accounts',
    'comparer',
]

REST_FRAMEWORK = {
    'DEFAULT_THROTTLE_RATES': {
        'video_search': '8/day',
        'video_id': '8/day'
    }
}

MIDDLEWARE = [
    '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.messages.middleware.MessageMiddleware',
    'django.middleware.clickjacking.XFrameOptionsMiddleware',
]

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [os.path.join(BASE_DIR, 'templates')],
        'APP_DIRS': True,
        'OPTIONS': {
            'context_processors': [
                'django.template.context_processors.debug',
                'django.template.context_processors.request',
                'django.contrib.auth.context_processors.auth',
                'django.template.context_processors.messages',
            ],
        },
    },
]

STATIC_URL = '/static/'
STATIC_ROOT = os.path.join(BASE_DIR, 'staticfiles')
STATICFILES_DIRS = [
    os.path.join(BASE_DIR, 'static')
]
STATICFILES_STORAGE = 'whitenoise.storage.CompressedManifestStaticFilesStorage'

错误日志 #

"GET / HTTP/1.1" 500 145

项目根urls.py #

from django.contrib import admin
from django.urls import path, include
from . import views
from django.views.generic.base import RedirectView
from django.conf import settings
from django.contrib.staticfiles.storage import staticfiles_storage

urlpatterns = [
    path('admin/', admin.site.urls),
    path('', views.index, name="index"),
    path('accounts/', include('accounts.urls'), name="accounts"),
    path('comparer/', include('comparer.urls'), name="comparer"),
    path('contact/', views.contact, name="contact"),
    path(
        "favicon.ico",
        RedirectView.as_view(url=staticfiles_storage.url("favicon.ico")),
    ),
]

视图函数代码 #

from django.shortcuts import render
from django.core.mail import EmailMessage
from django.template.loader import render_to_string
from django.conf import settings


def index(request):
    return render(request, 'index.html')

排查与解决方案 #

1. 获取完整错误堆栈
   DEBUG=False默认不输出错误详情，在settings.py中添加以下日志配置，重启服务访问首页即可在终端看到具体报错点：

   LOGGING = {
       'version': 1,
       'disable_existing_loggers': False,
       'handlers': {
           'console': {'class': 'logging.StreamHandler'},
       },
       'root': {'handlers': ['console'], 'level': 'WARNING'},
   }
   

2. 定位当前配置下的高频报错点
   • 核对index.html的静态资源引用规则：当前使用CompressedManifestStaticFilesStorage存储静态文件，要求所有模板内通过{% static %}标签引用的资源，必须存在于collectstatic生成的静态文件清单中。如果index.html内存在未使用{% static %}标签引入的资源、或对应文件未被收集到静态目录，会直接触发500错误，其余模板无此类资源因此渲染正常。需检查index.html内的css、js、图片路径，确保全部使用正确的{% static '资源路径' %}写法，且对应文件存在于项目static目录下。
   • 核对index.html的模板语法：如果index.html内使用了其他正常模板没有的自定义模板标签、或未定义的上下文变量，DEBUG=False时遇到这类问题会直接抛出500，不会像DEBUG=True时一样展示模板报错提示。可逐行对比index.html与其他正常模板的语法差异，移除自定义逻辑测试是否恢复。
   • 核对ALLOWED_HOSTS匹配规则：需确认线上实际访问的域名，与配置列表内的字符串完全一致，无大小写差异、多余空格。
3. 快速排除视图层因素
   临时将index视图替换为纯文本返回：

   from django.http import HttpResponse
   def index(request):
       return HttpResponse("test")
   

   若访问返回200，即可确认报错完全来自index.html模板本身。

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