Django项目中为不同应用配置独立404错误页面的方法

程一诺
程一诺
发布时间:2026-10-13 | 5人浏览过
原创

本文介绍如何在Django项目中为不同应用程序配置独立的404错误页面。通过创建自定义错误视图并在根urls.py中设置handler404,可根据URL路径动态加载特定模板。同时介绍了关闭调试模式、使用默认模板或自定义句柄两种实现方式,适用于Django 1.9及以上版本。

Django多应用独立404页面配置指南

是否存在一种方法,允许在Django项目的各个应用程序中分别创建多个自定义错误模板?具体而言,假设项目中包含三个应用程序,每个应用程序需要展示三种不同的404错误页面。

目前,后台应用和前台应用共用同一个404错误页面。

最佳解决方案

最佳解决方案:自定义错误视图

创建一个自定义错误视图,并将其分配给根urls.py中的handler404变量:

代码实现示例


from django.views.defaults import page_not_found
 
def my_error_404(request, exception):
 template_name = '404.html'
 if request.path.startswith('/backoffice/'):
  template_name='backoffice/404.html'
 elif request.path.startswith('/frontoffice/'):
  template_name='frontoffice/404.html'
 return page_not_found(request, exception, template_name=template_name)

此代码适用于Django 1.9。如果使用django<=1.9,则从视图中删除exception参数。

Django自定义错误页面配置方法

知识点补充:

Django 自定义 404 500 等错误页面

起步 要想自定义错误页面,需要关闭调试模式 DEBUG = False ,因为调试模式的错误页面是开发下会显示错误信息的。

有两种方法可以实现自定义的错误页面。

方法一:特定命名模板文件

方法一:创建特定命名的模板文件

这是一种非常简单的方式。在项目模板文件夹 templates 中创建命名为 404.html 的模板文件即可。

这个方式是其实是借用了 Django 的模板查找规则进行的。源码在 django.views.defaults.py 中:

ERROR_404_TEMPLATE_NAME = '404.html'

def page_not_found(request, exception, template_name=ERROR_404_TEMPLATE_NAME): ...

总的来说,方法一不需要设路由,只要新建规定名称的模板就能生效了。

方法二:设置句柄

方法二:设置句柄

如果需要更个性化的错误页面,不需要拘泥于特定的模板文件名,可以重新设置句柄,具体是在 urls.py 中设置:

urls.py配置示例


# urls.py
def page_not_found(request, exception):
 return render(request, 'your_404_filename.html')

handler404 = page_not_found

urlpatterns = [
 ...
]

除了能捕获不存在路由地址,还能捕获视图中 raise Http404('message') 抛出的异常。

可配置的错误状态码

哪些错误页面可以配置 具体能自定义错误页面的有 4 中状态码:

# django.views.defaults.py ERROR_404_TEMPLATE_NAME = '404.html' ERROR_403_TEMPLATE_NAME = '403.html' ERROR_400_TEMPLATE_NAME = '400.html' ERROR_500_TEMPLATE_NAME = '500.html'

# django.conf.urls.__init__.py handler400 = defaults.bad_request handler403 = defaults.permission_denied handler404 = defaults.page_not_found handler500 = defaults.server_error

总结

到此这篇关于python为Django项目上的每个应用程序创建不同的自定义404页面(最佳答案)的文章就介绍到这了,更多相关python django自定义404页面内容请搜索本站以前的文章或继续浏览下面的相关文章希望大家以后多多支持本站!

本站声明

本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。

Python 相关产品和应用

全部下载

专题列表