0

0

Django NoneType 错误深度解析与分类文章展示教程

DDD

DDD

发布时间:2025-11-24 11:37:00

|

943人浏览过

|

来源于php中文网

原创

Django NoneType 错误深度解析与分类文章展示教程

本教程深入探讨 django 中 `attributeerror: 'nonetype' object has no attribute 'views'` 错误的成因,特别是在 url 路由配置不当和数据查询为空时。文章将提供详细的视图逻辑修正、url 模式优化以及模板渲染的最佳实践,确保分类文章能正确显示,并避免因对象不存在而引发的运行时错误。

在 Django 开发中,AttributeError: 'NoneType' object has no attribute '...' 是一个非常常见的错误,它通常意味着你正在尝试访问一个 None 对象的属性。当数据库查询没有返回任何结果,或者在其他逻辑中变量被赋值为 None 时,就可能发生这种情况。本教程将以一个实际案例为例,详细讲解如何诊断、理解并解决这类问题,特别是在处理 URL 路由和分类文章展示功能时。

1. 理解 NoneType 错误根源

在提供的代码中,错误信息 AttributeError at /blog/cat1 'NoneType' object has no attribute 'views' 明确指出,在尝试访问一个 None 对象的 views 属性时发生了错误。结合堆信息,这通常发生在 blogPost 视图中:

# views.py
def blogPost(request, slug):
    post = Post.objects.filter(slug=slug).first() # 关键行
    post.views = post.views+1 # 错误发生在这里
    post.save()
    # ...

这里的关键在于 Post.objects.filter(slug=slug).first()。当数据库中不存在与给定 slug 匹配的 Post 对象时,first() 方法会返回 None。紧接着,下一行代码 post.views = post.views + 1 就会尝试访问 None 对象的 views 属性,从而引发 AttributeError: 'NoneType' object has no attribute 'views'。

2. 诊断与修正 URL 路由问题

导致上述错误的一个重要原因是 URL 路由配置不当,使得用户意图访问分类文章的请求被错误地匹配到了文章详情页视图。

观察 urls.py 文件:

# urls.py
from django.urls import path
from . import views

urlpatterns = [
    path('postComment', views.postComment, name='postComment'),
    path('', views.blogHome, name='blogHome'),
    path('<str:slug>', views.blogPost, name='blogPost'), # 文章详情页
    path('category/<category>/', views.blogCategory, name='blogCategory'), # 分类页
]

当用户访问 /blog/cat1 时,Django 的 URL 解析器会从上到下匹配 urlpatterns。 path('<str:slug>', views.blogPost, name='blogPost') 是一个非常通用的模式,它会匹配任何形如 /blog/something 的路径,并将 something 作为 slug 参数传递给 blogPost 视图。 因此,当请求 /blog/cat1 到来时,它会优先匹配到 blogPost 视图,并将 cat1 作为 slug。然而,cat1 是一个分类名称,很可能在 Post 模型的 slug 字段中不存在对应的文章,导致 Post.objects.filter(slug='cat1').first() 返回 None,进而引发错误。

修正策略:

  1. URL 模式顺序调整: 将更具体的 URL 模式放在更通用的模式之前。分类 URL path('category/<str:category_name>/', ...) 比文章详情页 URL path('<str:slug>', ...) 更具体,因为它包含了一个额外的路径段 category/。

  2. 参数类型和名称统一: 确保 URL 模式中捕获的参数类型和视图函数接收的参数类型一致。blogCategory 视图期望接收一个 pk (主键),但 URL 模式 path('category/<category>/', ...) 捕获的是一个字符串 category。为了清晰和一致,我们应将其改为更具描述性的 category_name 或 category_slug。

修改后的 urls.py 示例:

GentleAI
GentleAI

GentleAI是一个高效的AI工作平台,为普通人提供智能计算、简单易用的界面和专业技术支持。让人工智能服务每一个人。

下载
# urls.py
from django.urls import path
from . import views

urlpatterns = [
    path('postComment', views.postComment, name='postComment'),
    path('', views.blogHome, name='blogHome'),
    # 将分类URL放在文章详情URL之前,且使用更明确的参数名
    path('category/<str:category_name>/', views.blogCategory, name='blogCategory'),
    path('<str:slug>/', views.blogPost, name='blogPost'), # 建议在slug后也加斜杠保持一致性
]

注意: 在 path('<str:slug>/', ...) 中添加斜杠 / 是一种常见的最佳实践,有助于保持 URL 结构的一致性,避免重复内容,并简化 SEO。

3. 完善视图逻辑与数据获取

在修正了 URL 路由之后,我们还需要优化视图函数,以确保它们能够健壮地处理数据查询结果,并正确地传递数据给模板。

3.1 修正 blogPost 视图

为了避免 NoneType 错误,我们需要在访问 post 对象的属性之前,检查 post 是否为 None。

# views.py
from django.shortcuts import render, redirect, get_object_or_404
from blog.models import Post, BlogComment, Category
from django.contrib import messages
from blog.templatetags import extras
from django.core.paginator import Paginator, EmptyPage, PageNotAnInteger
import socket

def blogPost(request, slug):
    post = Post.objects.filter(slug=slug).first()

    if post is None:
        # 如果文章不存在,可以返回404错误,或者重定向到博客首页,或者显示一个消息
        # 这里我们使用 get_object_or_404 来简化处理
        # post = get_object_or_404(Post, slug=slug) # 这种方式更简洁,如果未找到会自动抛出404
        messages.error(request, '请求的文章不存在。')
        return redirect('blogHome') # 重定向到博客首页

    post.views = post.views + 1
    post.save()

    # comments
    comments = BlogComment.objects.filter(post=post, parent=None)
    replies = BlogComment.objects.filter(post=post).exclude(parent=None)
    replyDict = {}
    for reply in replies:
        if reply.parent.sno not in replyDict.keys():
            replyDict[reply.parent.sno] = [reply]
        else:
            replyDict[reply.parent.sno].append(reply)

    context = {'post': post, 'comments': comments, 'user': request.user, 'replyDict': replyDict}
    return render(request, 'blog/blogPost.html', context)

推荐使用 get_object_or_404: 实际上,对于查询单个对象且期望它必须存在的情况,get_object_or_404 函数是更简洁和符合 Django 惯例的选择。它会在对象不存在时自动抛出 Http404 异常。

# views.py (使用 get_object_or_404 优化)
def blogPost(request, slug):
    post = get_object_or_404(Post, slug=slug) # 如果找不到文章,会自动返回404页面

    post.views = post.views + 1
    post.save()

    # ... 后续评论逻辑不变 ...
    comments = BlogComment.objects.filter(post=post, parent=None)
    replies = BlogComment.objects.filter(post=post).exclude(parent=None)
    replyDict = {}
    for reply in replies:
        if reply.parent.sno not in replyDict.keys():
            replyDict[reply.parent.sno] = [reply]
        else:
            replyDict[reply.parent.sno].append(reply)

    context = {'post': post, 'comments': comments, 'user': request.user, 'replyDict': replyDict}
    return render(request, 'blog/blogPost.html', context)

3.2 修正 blogCategory 视图

原始的 blogCategory 视图期望接收一个 pk (主键),但我们修改后的 URL 模式传递的是 category_name。此外,视图需要获取该分类下的所有文章,而不是仅仅传递分类对象。

# views.py
def blogCategory(request, category_name): # 接收 category_name 参数
    # 根据名称获取分类对象,如果不存在则返回404
    category = get_object_or_404(Category, name=category_name)

    # 获取该分类下的所有文章
    # 由于 Category 模型中 Post 有 ManyToManyField('Category', related_name='posts')
    # 可以通过 category.posts.all() 来获取所有关联文章
    allPosts = category.posts.all().order_by("-timeStamp") # 按照时间倒序

    # 可以选择对分类文章进行分页
    paginator = Paginator(allPosts, 5) # 每页显示5篇文章
    page = request.GET.get('page')
    try:
        posts_paginated = paginator.page(page)
    except PageNotAnInteger:
        posts_paginated = paginator.page(1)
    except EmptyPage:
        posts_paginated = paginator.page(paginator.num_pages)

    context = {
        'category': category,
        'allPosts': posts_paginated, # 将分页后的文章列表传递给模板
        'page': 'pages' # 保持原有的分页上下文
    }
    return render(request, "blog/blogCategory.html", context)

4. 优化模板渲染与 URL 生成

blogCategory.html 模板也需要进行大幅度修改,以正确显示分类下的文章,并使用 Django 的 {% url %} 标签来生成正确的链接。

4.1 blogCategory.html 模板优化

原模板中 {% for category in post.categories.all %} 和 {% if posts == posts %} 存在逻辑错误。我们应该遍历从视图中传递过来的 allPosts (或 posts_paginated)。

{% extends "base.html" %}

{% block title %} 分类: {{ category.name }} {% endblock title %}
{% block blogactive %} active {% endblock blogactive %}
{% block body %}
<div class="container my-4">
    <h2>分类文章: {{ category.name }}</h2>

    {% if allPosts %} {# 检查是否有文章 #}
        {% for post in allPosts %} {# 遍历从视图传递过来的文章列表 #}
            <div class="card mb-3">
                <div class="card-body">
                    <div class="row g-0">
                        <div class="col-md-4">
                            <div class="ratio ratio-16x9">
                            <!-- featured image --> 
                                {% if post.thumbnail %} {# 检查是否有缩略图 #}
                                    <img src="{{ post.thumbnail.url }}" class="rounded featured-image-list" alt="{{post.title}}">
                                {% else %}
                                    <img src="https://via.placeholder.com/400x225?text=No+Image" class="rounded featured-image-list" alt="No Image">
                                {% endif %}
                            </div>
                        </div>
                        <div class="col-md-7 ps-md-3 pt-3 pt-md-0 d-flex flex-column">
                                <h2 class="card-title h3">
                                    {# 使用 {% url %} 标签生成文章详情页链接 #}
                                    <a href="{% url 'blogPost' slug=post.slug %}">{{ post.title }}</a>
                                </h2>
                                <div class="text-muted">
                                    <small>
                                        发布于 {{ post.timeStamp|date:"Y年m月d日 H:i" }} 作者: <strong>{{ post.author }}</strong>
                                    </small>
                                </div>
                                <p class="card-text mb-auto py-2">{{ post.content|safe|striptags|truncatechars:300 }}</p>
                                <div>
                                    {# 使用 {% url %} 标签生成文章详情页链接 #}
                                    <a href="{% url 'blogPost' slug=post.slug %}" class="btn btn-primary">阅读更多</a> | 分类:
                                    {% for cat in post.categories.all %} {# 遍历当前文章的分类 #}
                                        {# 使用 {% url %} 标签生成分类页链接 #}
                                        <a href="{% url 'blogCategory' category_name=cat.name %}">
                                            {{ cat.name }}
                                        </a>{% if not forloop.last %}, {% endif %}
                                    {% endfor %}
                                </div>
                        </div>
                    </div>
                </div>
            </div>
        {% endfor %}

        {# 分页导航 #}
        {% if allPosts.has_other_pages %}
        <nav aria-label="Page navigation example">
            <ul class="pagination justify-content-center">
                {% if allPosts.has_previous %}
                    <li class="page-item"><a class="page-link" href="?page={{ allPosts.previous_page_number }}">上一页</a></li>
                {% else %}
                    <li class="page-item disabled"><span class="page-link">上一页</span></li>
                {% endif %}

                {% for i in allPosts.paginator.page_range %}
                    {% if allPosts.number == i %}
                        <li class="page-item active"><span class="page-link">{{ i }}</span></li>
                    {% else %}
                        <li class="page-item"><a class="page-link" href="?page={{ i }}">{{ i }}</a></li>
                    {% endif %}
                {% endfor %}

                {% if allPosts.has_next %}
                    <li class="page-item"><a class="page-link" href="?page={{ allPosts.next_page_number }}">下一页</a></li>
                {% else %}
                    <li class="page-item disabled"><span class="page-link">下一页</span></li>
                {% endif %}
            </ul>
        </nav>
        {% endif %}

    {% else %}
        <p>该分类下暂无文章。</p>
        <p>您的搜索未匹配到任何文章。</p>
        <br>
        建议: <br>
        <ul>
            <li>确保所有单词拼写正确。</li>
            <li>尝试使用不同的关键词。</li>
            <li>尝试使用更通用的关键词。</li>
            <li>尝试使用更少的关键词。</li>
        </ul>
    {% endif %}

</div>
{% endblock body %}

4.2 blogPost.html 模板中的 URL 修正

虽然 blogPost.html 没有直接导致本教程的 NoneType 错误,但为了保持一致性和最佳实践,也应将其中硬编码的 URL 替换为 {% url %} 标签。

<!-- 示例:在 blogPost.html 中 -->
<h2 class="card-title h3">
    {# 正确使用 {% url %} 标签生成文章详情页链接 #}
    <a href="{% url 'blogPost' slug=post.slug %}">{{ post.title }}</a>
</h2>

<!-- ... -->

<div>
    {# 正确使用 {% url %} 标签生成文章详情页链接 #}
    <a href="{% url 'blogPost

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
Python Web 框架 Django 深度开发
Python Web 框架 Django 深度开发

本专题系统讲解 Python Django 框架的核心功能与进阶开发技巧,包括 Django 项目结构、数据库模型与迁移、视图与模板渲染、表单与认证管理、RESTful API 开发、Django 中间件与缓存优化、部署与性能调优。通过实战案例,帮助学习者掌握 使用 Django 快速构建功能全面的 Web 应用与全栈开发能力。

166

2026.02.04

if什么意思
if什么意思

if的意思是“如果”的条件。它是一个用于引导条件语句的关键词,用于根据特定条件的真假情况来执行不同的代码块。本专题提供if什么意思的相关文章,供大家免费阅读。

847

2023.08.22

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

761

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

221

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1568

2023.10.24

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

651

2023.11.24

java读取文件转成字符串的方法
java读取文件转成字符串的方法

Java8引入了新的文件I/O API,使用java.nio.file.Files类读取文件内容更加方便。对于较旧版本的Java,可以使用java.io.FileReader和java.io.BufferedReader来读取文件。在这些方法中,你需要将文件路径替换为你的实际文件路径,并且可能需要处理可能的IOException异常。想了解更多java的相关内容,可以阅读本专题下面的文章。

1228

2024.03.22

php中定义字符串的方式
php中定义字符串的方式

php中定义字符串的方式:单引号;双引号;heredoc语法等等。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

1204

2024.04.29

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

26

2026.03.13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Bootstrap 5教程
Bootstrap 5教程

共46课时 | 3.6万人学习

AngularJS教程
AngularJS教程

共24课时 | 4.2万人学习

CSS教程
CSS教程

共754课时 | 43万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号