Django Debug Toolbar不显示类视图真实类名仅显示视图路径如何解决

• 框架版本：Django==4.0.5
• 调试工具版本：django-debug-toolbar==3.4.0

Django Debug Toolbar 除视图标识展示外其余功能均可正常运行，工具栏未正确显示自定义类视图的类名DashboardView，反而展示为backend_base.views.view。
异常对应类视图代码如下：

class DashboardView(LoginRequiredMixin, NavBarMixin, TemplateView):
    template_name = 'dashboard.html'

同项目历史版本中，Debug Toolbar可正常展示对应视图的真实类名，需定位配置遗漏点。

该异常是django-debug-toolbar无法读取到类视图的原始类信息导致的：
类视图调用as_view()方法后会返回一个名为view的内层函数，正常情况下该函数会携带view_class属性指向原始类，debug-toolbar会优先读取该属性展示真实类名；一旦这个属性丢失，工具栏就只能读取到内层函数默认的view名称，拼接模块名后就会出现backend_base.views.view的异常展示。
结合版本变更背景，3.4.0版本的django-debug-toolbar调整了视图属性的读取逻辑，移除了旧版本通过栈回溯兜底识别类名的逻辑，仅通过视图函数挂载的属性识别类信息，对属性透传的要求更严格，以下常见配置错误都会触发该问题：

• URLconf中没有直接绑定DashboardView.as_view()的返回值，而是导入了视图文件中提前赋值的view = DashboardView.as_view()变量
• 对as_view()返回的视图函数做了自定义装饰器包装，但没有使用functools.wraps做属性透传，也没有手动复制view_class属性
• 自定义Mixin（如代码中的NavBarMixin）重写了as_view()方法，但没有正确保留父类方法返回的函数属性

按照优先级逐一排查修复即可：

1. 检查URL路由配置，直接在路由规则中调用as_view()，不要提前赋值为同名view变量再导入，正确写法示例：

   # urls.py
   from django.urls import path
   from backend_base.views import DashboardView
   
   urlpatterns = [
       path('dashboard/', DashboardView.as_view(), name='dashboard'),
   ]
   

2. 如果需要给类视图加装饰器（如登录校验、权限校验），优先使用Django内置的method_decorator直接装饰视图类，不要装饰as_view()返回的函数，避免属性丢失：

   from django.utils.decorators import method_decorator
   from django.contrib.auth.decorators import login_required
   
   @method_decorator(login_required, name='dispatch')
   class DashboardView(NavBarMixin, TemplateView):
       template_name = 'dashboard.html'
   

3. 如果必须包装as_view()返回的函数，装饰器必须使用functools.wraps，同时手动透传类视图专属属性：

   import functools
   
   def custom_view_decorator(view_func):
       @functools.wraps(view_func)
       def wrapper(*args, **kwargs):
           # 自定义装饰逻辑
           return view_func(*args, **kwargs)
       # 手动透传类视图属性
       wrapper.view_class = getattr(view_func, 'view_class', None)
       wrapper.view_initkwargs = getattr(view_func, 'view_initkwargs', {})
       return wrapper
   

4. 检查自定义NavBarMixin的as_view()方法，如果做了重写，确保调用父类as_view()方法后直接返回结果，不要额外包装丢失属性。

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