Django 404页面无法重定向至首页，请求技术解决方案

现有配置中的核心错误 #

• 404视图定义无效：你在views.py里写的class view_404(request, exception=None)不符合Django视图规范——类视图必须继承View基类，且参数写法错误；同时Django的handler404要求接收request和exception参数的函数，或正确转换后的类视图。
• handler404指向错误：你将handler404设为首页视图mysite.views.index，但未正确关联到自定义404处理逻辑，导致规则不生效。
• Nginx配置路径不明确：Nginx的root或alias路径未精准对应模板位置，即使配置了error_page也无法正确找到首页文件。

正确配置步骤 #

1. 修复404视图定义 #

在views.py中选择以下一种正确写法：

函数式视图（推荐）

from django.shortcuts import render

def view_404(request, exception=None):
    # 返回首页模板，保留404状态码；若需强制重定向用redirect(status=302)
    return render(request, "mysite/index.html", status=404)

类视图

from django.views import View
from django.shortcuts import render

class View404(View):
    def get(self, request, exception=None):
        return render(request, "mysite/index.html", status=404)

2. 配置urls.py中的handler404 #

确保handler404指向正确的视图，且放在urlpatterns之后：

from django.conf.urls import handler404
from . import views

urlpatterns = [
    path('', views.index, name='index')
]

# 函数式视图写法
handler404 = "mysite.views.view_404"
# 类视图写法（需加as_view()转换）
# handler404 = "mysite.views.View404.as_view()"

3. 验证Django基础配置 #

• 确认settings.py中DEBUG=False（生产环境必须关闭，否则Django会显示默认调试页面）。
• 配置正确的ALLOWED_HOSTS，例如：

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

• 检查TEMPLATES配置，确保mysite/index.html存在于指定的模板目录中。

4. 调整Nginx配置（可选） #

若要通过Nginx直接处理404，需精准指定首页文件路径：

server {
    # 其他配置（监听端口、反向代理Django等）...
    
    error_page 404 /index.html;
    location = /index.html {
        # 直接指向首页模板的绝对路径
        alias /path/to/your/project/templates/mysite/index.html;
        internal;
    }
}

验证方法 #

1. 重启Django服务和Nginx服务。
2. 访问不存在的路径（如your-domain.com/non-existent），检查是否返回首页。
3. 查看Django日志，确认404请求是否触发了自定义视图。

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