Django自定义404页面无法渲染问题求助

先明确核心矛盾点 #

你描述中提到“已确认settings中的DEBUG设为True”，但给出的Settings配置代码里写的是DEBUG = False——这是关键问题：Django在DEBUG=True模式下会强制显示自带的调试404页面，完全忽略自定义的handler404配置，只有当DEBUG=False时才会触发自定义404视图。

分步排查与修复 #

1. 强制确认DEBUG模式状态

• 必须将settings.py中的DEBUG设为False，这是触发自定义404的前提。
• 验证实际生效配置：在终端执行python manage.py shell，输入以下命令确认：

  from django.conf import settings
  print(settings.DEBUG)
  

  如果输出True，说明配置未正确生效（可能是配置文件被覆盖、环境变量优先级更高等）。

2. 检查handler404的配置位置

• handler404必须配置在**项目根目录的urls.py**中，而非某个app的urls.py。如果你的handler404 = 'home1.views.custom_404_view'写在app的urls文件里，Django无法识别，需移到根urls.py。

3. 验证模板路径与加载逻辑

• 确认模板文件路径：error404.html需放在home1 app的templates/home1/目录下（即项目结构为home1/templates/home1/error404.html），匹配视图中render(request, 'home1/error404.html', ...)的路径。
• 检查模板加载配置：确保settings.py中INSTALLED_APPS包含你的'home1' app，且TEMPLATES配置里的APP_DIRS设为True：

  TEMPLATES = [
      {
          'BACKEND': 'django.template.backends.django.DjangoTemplates',
          'DIRS': [],
          'APP_DIRS': True,  # 必须为True，才能加载app下的templates目录
          'OPTIONS': {
              # ...其他配置
          },
      },
  ]
  

4. 直接测试自定义视图可用性

• 在根urls.py中添加临时测试路由，直接调用自定义404视图：

  from home1.views import custom_404_view
  
  urlpatterns = [
      # ...其他路由
      path('test-404/', custom_404_view, kwargs={'exception': None}),
  ]
  

  访问/test-404/：
  • 如果能看到自定义页面：说明视图和模板正常，问题出在404触发逻辑（回到前两步排查DEBUG和handler404位置）；
  • 如果看不到：检查视图是否正确返回响应、模板是否存在语法错误（比如HTML标签未闭合）。

5. 确认ALLOWED_HOSTS配置（DEBUG=False时必填）

• DEBUG=False时，必须确保请求的主机在ALLOWED_HOSTS列表中，否则Django会直接返回400错误，无法触发404视图。比如用localhost访问就必须包含'localhost'，用IP访问就必须添加对应IP。

6. 重启服务清除缓存

修改配置后必须重启Django开发服务器，避免旧配置缓存生效；生产环境还需清除模板缓存与静态文件缓存。

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