Django Session 中实现“最近浏览”功能的完整教程-html教程-PHP中文网

Django Session 中实现“最近浏览”功能的完整教程

本文详解如何在 Django 中利用 session 正确存储和展示用户最近浏览的商品，重点解决模板中 recently_viewed 查询集未渲染的问题，并提供健壮、可复用的实现方案。

本文详解如何在 django 中利用 session 正确存储和展示用户最近浏览的商品，重点解决模板中 `recently_viewed` 查询集未渲染的问题，并提供健壮、可复用的实现方案。

在 Django 项目中实现“最近浏览”功能时，一个常见误区是：视图中将查询集（QuerySet）正确传递给模板，但模板却使用了错误的上下文变量名进行判断和遍历。从你提供的代码可见，问题根源非常明确：

✅ 在 detail 视图中，你已正确构建并传入了 recently_viewed_qs：

recently_viewed_qs = Item.objects.filter(pk__in=request.session.get("recently_viewed", []))[:3]
# ...
return render(request, 'item/detail.html', {
    # ...
    'recently_viewed': recently_viewed_qs,  # ← 注意：这里键名是 'recently_viewed'
})

❌ 而在 index.html（或实际应为 detail.html —— 因为你在商品详情页展示“最近浏览”，且该逻辑位于 detail 视图中）中，你却检查的是 recently_viewed_qs：

{% if recently_viewed_qs %}  <!-- ❌ 模板中不存在这个变量 -->

这导致条件始终为 False，直接跳过循环，显示 “No recently viewed items.”。

✅ 正确做法：保持上下文键名一致

只需将模板中的变量名统一为视图中传递的键名 'recently_viewed'：

Build Session

支持专注的自主工作时段，构建、创作或产出一个具体成果，并高效记录和提交进度。

下载

<div class="mt-6 px-6 py-12 bg-gray-100 rounded-xl">
    <h2 class="mb-12 text-2xl text-center">Recently Viewed Items</h2>

    <div class="grid grid-cols-3 gap-3">
        {% if recently_viewed %}
            {% for item in recently_viewed %}
                <div>
                    <a href="%7B%%20url%20'item:detail'%20item.id%20%%7D">
                        <div>
                            @@##@@
                        </div>
                        <div class="p-6 bg-white rounded-b-xl">
                            <h2 class="text-2xl">{{ item.name }}</h2>
                        </div>
                    </a>
                </div>
            {% endfor %}
        {% else %}
            <p class="col-span-3 text-center text-gray-500">No recently viewed items.</p>
        {% endif %}
    </div>
</div>

? 关键验证点：你日志中已打印出 recently viewed qs <queryset red shoes>, ...]></queryset>，说明数据已成功生成并传入模板——只需修正模板变量引用即可生效。

✅ 进阶优化建议（提升健壮性与可维护性）

会话操作封装为工具函数
避免在视图中重复编写 session 逻辑，推荐提取为独立函数（如 utils.py）：

# utils.py
def add_to_recently_viewed(request, item_id, max_items=5):
    viewed = request.session.get('recently_viewed', [])
    if item_id in viewed:
        viewed.remove(item_id)
    viewed.insert(0, item_id)
    request.session['recently_viewed'] = viewed[:max_items]
    request.session.modified = True

在 detail 视图中调用：

from .utils import add_to_recently_viewed
# ...
add_to_recently_viewed(request, item.pk)
recently_viewed = Item.objects.filter(pk__in=request.session.get('recently_viewed', []))

处理图片缺失风险
使用 {% if item.image %} 防止 item.image.url 报错：
```
@@##@@
```
登录用户专属（可选增强）
当前逻辑基于 session，对所有用户通用。若需严格绑定登录用户（如跨设备同步），建议改用数据库模型（如 UserRecentView），而非 session。