Django自定义错误页不生效：返回HttpResponse错误时无法跳转至自定义模板

问题现象 #

• 已配置400/403/404/500自定义错误视图，但主动返回HttpResponse(status=xxx)时，无法触发自定义模板，显示默认错误内容；
• 访问不存在的URL（如http://127.0.0.1:8000/404/）时，能正常跳转至自定义错误页面。

核心原因 #

Django的handler4xx/handler5xx仅处理框架层面抛出的异常，而非直接返回的HttpResponse状态码：

• handler404：触发于URL路由匹配失败，或主动raise Http404；
• handler403：触发于抛出PermissionDenied异常；
• handler400：触发于抛出SuspiciousOperation等异常；
• handler500：触发于服务器未捕获的内部异常；
  直接返回HttpResponse(status=xxx)只是返回带状态码的响应，不会触发错误处理视图。

解决方案 #

1. 主动抛出对应异常（推荐）

在需要返回错误的视图中，通过抛出Django内置异常触发自定义错误视图：

# 触发404
from django.http import Http404
raise Http404("页面不存在")

# 触发403
from django.core.exceptions import PermissionDenied
raise PermissionDenied("无访问权限")

# 触发400
from django.core.exceptions import SuspiciousOperation
raise SuspiciousOperation("无效请求")

# 触发500
# 直接让代码抛出未捕获异常即可，比如调用不存在的方法

2. 封装工具函数直接调用错误视图

如果不想抛出异常，可封装函数直接调用已定义的错误视图：

# 在views.py中添加工具函数
def render_custom_error(request, status_code):
    if status_code == 404:
        return page_not_found_view(request, exception=None)
    elif status_code == 403:
        return forbidden_error_view(request, exception=None)
    elif status_code == 400:
        return bad_request_error_view(request, exception=None)
    elif status_code == 500:
        return internal_server_error_view(request)
    return HttpResponse(status=status_code)

# 在业务视图中使用
def your_business_view(request):
    # 业务逻辑判断
    return render_custom_error(request, 404)

3. 修正配置错误

检查urls.py中的拼写错误：原代码中hanlder400少了一个字母d，修正后才能正常触发400错误视图：

# urls.py 正确配置
handler400 = "gotani.views.bad_request_error_view"
handler404 = "gotani.views.page_not_found_view"
handler403 = "gotani.views.forbidden_error_view"
handler500 = "gotani.views.internal_server_error_view"

4. 确认DEBUG模式关闭

只有当settings.py中DEBUG = False时，Django才会使用自定义错误视图，DEBUG模式下会显示默认调试页面。

内容的提问来源于stack exchange，提问作者Chuen Yik Kang