Django详情链接触发TemplateDoesNotExist及详情不显示问题排查

一、先处理TemplateDoesNotExist错误 #

你遇到的TemplateDoesNotExist at /app/detail/3/问题，核心原因是Django的generic.DetailView类视图有默认的模板命名规则：它会自动寻找应用名/模型名_detail.html格式的模板，也就是你的场景下的app/post_detail.html——哪怕你自己写了detail函数视图，只要路由里配置的是DetailView类视图，它就会优先遵循这个默认规则找模板。

你有两种修复方向：

方向1：继续使用自定义的detail函数视图 #

检查你的URL配置，确保detail路由指向的是你写的函数，而不是类视图。比如urls.py里应该是这样：

path('detail/<int:pk>/', views.detail, name='detail')

这样配置后，访问链接时就会执行你写的detail函数，它会加载你指定的detail.html模板，不会再去找post_detail.html了。

方向2：改用DetailView类视图 #

如果你想使用类视图简化代码，那需要在类里明确指定模板路径，就像你后来修改的那样：

class DetailView(generic.DetailView):
    model = POST
    template_name = 'detail.html'  # 手动指定模板，覆盖默认规则

同时要确保路由配置正确指向类视图的as_view()方法：

path('detail/<int:pk>/', views.DetailView.as_view(), name='detail')

二、解决修改后页面无内容的问题 #

你把detail.html里的content改成post后还是没内容？其实问题出在DetailView的上下文变量命名规则上：

DetailView默认会把查询到的模型对象以模型类名的小写形式传递给模板，你的模型是POST，所以默认变量名是post，而不是你自定义函数里用的content。

所以你有两种调整方式：

方式1：调整模板变量名 #

保持类视图的配置不变，模板里用默认的post变量：

<h2>{{ post.title }}</h2>
<p>{{ post.text }}</p>

这样就能正常显示内容了，前提是你的类视图已经正确指定了model = POST，路由也配置正确。

方式2：自定义上下文变量名 #

如果你想继续在模板里用content作为变量名，可以在DetailView里添加context_object_name属性：

class DetailView(generic.DetailView):
    model = POST
    template_name = 'detail.html'
    context_object_name = 'content'  # 自定义上下文变量名

这样模板里就能继续用{{ content.title }}和{{ content.text }}，不用改模板代码。

最后总结一下 #

• 如果喜欢手写逻辑，就用自定义函数视图，确保路由指向函数，模板用content变量。
• 如果想用Django的通用类视图简化代码，就配置好template_name和可选的context_object_name，路由指向类视图的as_view()方法，模板对应好变量名。

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