Django博客Slug对应详情页无法打开问题求助

问题现象 #

URL中能正确显示文章的slug，但点击跳转后页面始终停留在首页，无法进入对应的博客详情页。

核心错误与修复方案 #

1. URL路由配置错误（urls.py） #

Django的URL路由是从上到下匹配，原配置中第一个空字符串路由会匹配所有请求（包括带slug的路径），导致详情页路由永远不会被触发。同时使用re_path的写法不符合正则规则，建议改用更简洁的path。

修正后的urls.py：

from django.urls import path

urlpatterns = [
    path('', views.PostList.as_view(), name='home'),
    path('<str:slug>/', views.post_detail, name='post_detail'),  # 统一小写命名规范，末尾加/保证匹配逻辑正确
]

2. 视图函数错误（views.py） #

• 变量名Post与模型名冲突，易引发逻辑混淆
• 未将上下文context传入render函数，导致模板无法获取文章数据
• 函数名未遵循PEP8小写命名规范

修正后的views.py：

def post_detail(request, slug):
    post = Post.objects.filter(slug=slug).first()
    context = {'post': post}  # 键名改为小写，符合模板使用习惯
    return render(request, 'blog/post_details.html', context)  # 必须传入上下文

class PostList(generic.ListView):
    queryset = Post.objects.all().order_by('-created_on')
    template_name = 'index.html'

3. 模板链接硬编码问题（index.html） #

原代码直接硬写/blog/{{post.slug}}，既不灵活也容易出错，建议使用Django的{% url %}标签生成链接，保证与路由配置一致。

修正后的index.html链接部分：

<!-- 替换原硬编码链接 -->
<a href="{% url 'post_detail' post.slug %}" class="btn btn-primary">Read More &rarr;</a>

如果项目根URL包含blog/前缀，需在根urls.py中配置子路由前缀：

# 根urls.py
path('blog/', include('你的博客应用名.urls')),

4. 详情页模板错误（post_details.html） #

• 使用{% include 'base.html' %}而非{% extends %}，导致模板块{% block content %}无法正常替换
• 模板中混用object和post变量，且与上下文传递的键名不匹配
• 模型get_absolute_url方法中的路由名称与实际路由名称不一致

修正后的post_details.html：

{% extends "base.html" %}  <!-- 替换include为extends，正确继承母版 -->

{% block content %}
<div class="container">
  <div class="row">
    <div class="col-md-8 card mb-4  mt-3 left  top">
      <div class="card-body">
        <h1>{% block title %} {{ post.title }} {% endblock title %}</h1>
        <p class=" text-muted">{{ post.author }} | {{ post.created_on }}</p>
        <p class="card-text ">{{ post.content | safe }}</p>
      </div>
    </div>
  </div>
</div>
{% endblock content %}

同时修正模型中的get_absolute_url方法，保证路由名称一致：

# models.py
def get_absolute_url(self):
    return reverse("post_detail", kwargs={"slug": self.slug})  # 对应路由名称post_detail

额外注意事项 #

• 确保slug字段在创建文章时已正确生成（可使用django-autoslug库自动生成，或在模型保存时手动处理）
• 修改代码后重启Django服务器，确保配置生效
• 查看浏览器控制台是否有404错误，确认路由匹配逻辑是否正确

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