DEBUG=False时Django Admin与可浏览式API无法访问的问题

1. 静态文件配置（最可能触发问题的原因） #

当DEBUG=False时，Django默认不再自动托管静态文件，但Admin站点和DRF可浏览式API依赖自身的CSS、JS、图标等静态资源，缺失这些资源会直接导致500错误。

解决步骤：

• 完善settings.py中的静态文件配置：

  import os
  STATIC_URL = '/static/'
  # 生产环境收集静态文件的统一目录
  STATIC_ROOT = os.path.join(BASE_DIR, 'staticfiles')
  # 项目级静态文件目录（如果有自定义静态资源）
  STATICFILES_DIRS = [
      os.path.join(BASE_DIR, 'static'),
  ]
  

• 执行静态文件收集命令，将所有app的静态资源归集到STATIC_ROOT：

  python manage.py collectstatic
  

• 生产环境需用Nginx/Apache托管staticfiles目录，或用Whitenoise中间件让Django直接处理静态文件（适合小型项目）：
  安装依赖：

  pip install whitenoise
  

  修改settings.py的MIDDLEWARE（放在SecurityMiddleware之后）：

  MIDDLEWARE = [
      'django.middleware.security.SecurityMiddleware',
      'whitenoise.middleware.WhiteNoiseMiddleware',  # 新增该行
      ...  # 其他中间件
  ]
  

  添加静态文件存储配置：

  STATICFILES_STORAGE = 'whitenoise.storage.CompressedManifestStaticFilesStorage'
  

2. 模板路径配置检查 #

你的应用都嵌套在backend目录下，DEBUG=False时Django的模板查找机制更严格，可能无法正确定位Admin/DRF的模板或自定义模板。

确认settings.py的TEMPLATES配置正确：

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [os.path.join(BASE_DIR, 'templates')],  # 项目级模板目录
        'APP_DIRS': True,  # 允许自动查找各app下的templates目录
        'OPTIONS': {
            'context_processors': [
                'django.template.context_processors.debug',
                'django.template.context_processors.request',
                'django.contrib.auth.context_processors.auth',
                'django.contrib.messages.context_processors.messages',
            ],
        },
    },
]

同时保证各app的模板目录结构合规，比如backend/projects/templates/projects/xxx.html，避免跨app模板命名冲突。

3. ALLOWED_HOSTS 配置校验 #

虽然根路径和JSON API正常，但仍需确认settings.py中ALLOWED_HOSTS包含当前服务器的域名/IP，否则可能导致页面渲染类请求出错：

ALLOWED_HOSTS = ['your-domain.com', '127.0.0.1', 'localhost']

4. 查看详细错误日志 #

DEBUG=False时Django不会将错误输出到控制台，需配置日志定位具体问题：
在settings.py中添加日志配置：

LOGGING = {
    'version': 1,
    'disable_existing_loggers': False,
    'handlers': {
        'file': {
            'level': 'ERROR',
            'class': 'logging.FileHandler',
            'filename': os.path.join(BASE_DIR, 'django_errors.log'),
        },
    },
    'loggers': {
        'django': {
            'handlers': ['file'],
            'level': 'ERROR',
            'propagate': True,
        },
    },
}

触发错误后查看django_errors.log，可获取精准的错误堆栈信息。

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