Django多模型合并传入同一视图模板仅politics渲染异常排查

核心原因 #

• 模板Post渲染区块标签未闭合：Post对应的循环{% for post in posts reversed %}和条件判断{% if forloop.counter < 5 %}没有匹配的{% endfor %}、{% endif %}闭合标签，属于Django模板语法错误，模板引擎解析到未闭合块标签时会直接终止该section的渲染，不会输出任何Post相关内容，这是Post数据不显示的首要原因。Politics区块的模板标签是完整闭合的，所以能正常渲染。
• 模型字段缺失+字段配置不合理：两个模型都没有定义模板中调用的category字段，同时Post模型的image字段没有设置blank=True、null=True，只要存在一条Post记录未上传图片，访问post.image.url就会抛出值错误，进一步阻断区块渲染。
• 模板层逻辑冗余：在模板里做反转、条数判断的效率远低于视图层直接查询切片，还容易因为查询集默认排序规则不符合预期，导致没有内容输出。

修复步骤 #

1. 调整视图查询逻辑 #

把排序、切片逻辑移到视图层，减少模板运算，只向前端传递需要展示的数据：

from .models import Post, Politics

def index(request):
    # 按创建时间倒序，时政类取最新10条、普通文章取最新4条
    politics = Politics.objects.all().order_by('-created_at')[:10]
    posts = Post.objects.all().order_by('-created_at')[:4]
    return render(request, 'index.html', {
        'politics': politics,
        'posts': posts
    })

2. 补全模型配置 #

给两个模型补全用到的字段，给图片字段加空值允许配置，避免无图记录触发报错：

class Post(models.Model):
    title = models.CharField(max_length=100)
    body = RichTextField(max_length=1000000)
    created_at = models.DateTimeField(default=datetime.now, blank=True)
    # 允许空图，避免无图记录调用url报错
    image = ResizedImageField(size=[250, 200], upload_to='img', blank=True, null=True)
    # 补全模板用到的分类字段，可根据需求改成外键关联分类表
    category = models.CharField(max_length=50, default="普通资讯")

class Politics(models.Model):
    title = models.CharField(max_length=100)
    body = RichTextField(max_length=1000000)
    created_at = models.DateTimeField(default=datetime.now, blank=True)
    image = ResizedImageField(size=[250, 200], upload_to='img', blank=True, null=True)
    # 补全分类字段
    category = models.CharField(max_length=50, default="时政资讯")

模型修改完成后，依次执行以下命令同步数据库结构：

python manage.py makemigrations
python manage.py migrate

3. 修复模板语法问题 #

补全Post区块的闭合标签，移除冗余的条数判断（视图层已经完成切片），给图片字段加兜底判断，避免无图时出错：

<section id="posts" class="posts">
  <div class="container" data-aos="fade-up">
    <div class="row g-5">
      {% for post in posts %}
      <div class="post-entry-1 col-lg-2 box mx-1">
        <a href="/post/{{post.id}}">
          {% if post.image %}
          <img src="{{post.image.url}}" class="post_img">
          {% else %}
          <!-- 替换成你项目里的默认占位图路径 -->
          <img src="{% static 'assets/img/default-post.jpg' %}" class="post_img">
          {% endif %}
        </a>
        <div>
          <div class="post-meta">
            <span class="date">{{post.category}}</span>
            <span class="mx-1">&bullet;</span>
            <span>{{post.created_at|date:"Y-m-d"}}</span>
          </div>
          <h2><a href="/post/{{post.id}}">{{post.title}}</a></h2>
        </div>
        <p class="mb-4 d-block">{{post.body|truncatewords:75}}</p>
        <div class="d-flex align-items-center author">
          <div class="photo">
            <img src="{% static 'assets/img/person-1.jpg' %}" alt="" class="img-fluid">
          </div>
          <div class="name">
            <h3 class="m-0 p-0">OlePundit</h3>
          </div>
        </div>
      </div>
      <!-- 补全之前缺失的循环闭合标签 -->
      {% endfor %}
    </div>
  </div>
</section>

Politics渲染区块也同步加图片兜底判断，提升稳定性：

<div class="row">
  {% for politic in politics%}
  <div class="post-entry-1 col-2 mx-1">
    <a href="/politicalpost/{{politic.id}}">
      {% if politic.image %}
      <img src="{{politic.image.url}}" alt="" class="post_img">
      {% else %}
      <img src="{% static 'assets/img/default-politic.jpg' %}" alt="" class="post_img">
      {% endif %}
    </a>
    <div class="post-meta">
      <span class="date">{{politic.category}}</span> 
      <span class="mx-1">&bullet;</span> 
      <span>{{politic.created_at|date:"Y-m-d"}}</span>
    </div>
    <h2 class="mb-2"><a href="/politicalpost/{{politic.id}}">{{politic.title}}</a></h2>
    <span class="author mb-3 d-block">Ole Pundit</span>
    <p class="mb-4 d-block">{{politic.body|safe|truncatewords:20}}</p>
  </div>
  {% endfor %}
</div>

改完重启Django服务即可正常显示两类内容。

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