如何在Django中从HTML模板向视图传递字典？urlencode失效问题

问题原因 #

直接使用{{ listing|urlencode }}无法正确生成查询字符串，大概率是因为：

• Django默认的urlencode过滤器对嵌套字典、非字符串类型值的支持有限
• 模板中直接传入普通Python字典时，过滤器没有按预期解析键值对结构

解决方案 #

方法1：手动拼接查询参数（适合扁平字典） #

如果你的listing是无嵌套的扁平字典，直接在模板中遍历键值对拼接即可，同时对每个值单独编码避免特殊字符问题：

<h2>
  <a href="{% url 'listingpage' %}?{% for key, value in listing.items %}
    {{ key }}={{ value|urlencode }}{% if not forloop.last %}&{% endif %}
  {% endfor %}">
    {{ listing.title }}
  </a>
</h2>

• 用{% if not forloop.last %}避免末尾多余的&符号
• 对每个value单独使用urlencode处理特殊字符（比如空格、中文）

方法2：自定义模板过滤器（支持复杂结构） #

如果字典有嵌套、列表类型的值，自定义过滤器能更灵活地处理：

1. 在你的Django app下创建templatetags目录，添加__init__.py和custom_filters.py文件
2. 在custom_filters.py中实现过滤器：

from django import template
from urllib.parse import urlencode

register = template.Library()

def dict_to_querystring(value):
    # 过滤空值，避免无效参数
    filtered_data = {k: v for k, v in value.items() if v not in (None, '', [])}
    # doseq=True支持列表类型参数（比如tags: ['a','b']会转成tags=a&tags=b）
    return urlencode(filtered_data, doseq=True)

register.filter('dict_to_querystring', dict_to_querystring)

3. 在模板中加载并使用过滤器：

{% load custom_filters %}

<h2><a href="{% url 'listingpage' %}?{{ listing|dict_to_querystring }}">{{ listing.title }}</a></h2>

方法3：传递JSON字符串（适合复杂嵌套结构） #

如果字典层级很深，把它序列化成JSON字符串传递是更简洁的方式：

1. 在视图中把listing转成JSON字符串传到模板：

import json
from django.shortcuts import render

def some_view(request):
    listing = {"title": "Test", "user": {"name": "Alice", "age": 30}}
    listing_json = json.dumps(listing)
    return render(request, 'your_template.html', {"listing": listing, "listing_json": listing_json})

2. 模板中传递JSON字符串：

<h2><a href="{% url 'listingpage' %}?data={{ listing_json|urlencode }}">{{ listing.title }}</a></h2>

3. 在目标视图中解析JSON：

import json
from django.shortcuts import render

def listingpage(request, listing_id=None):
    data_json = request.GET.get('data')
    if data_json:
        listing_dict = json.loads(data_json)
        print(listing_dict)
    # 后续逻辑
    return render(request, 'listingpage.html')

视图中接收参数的方式 #

无论用哪种方法，视图里都可以通过request.GET获取传递的参数：

def listingpage(request, listing_id=None):
    # 获取单个参数值
    title = request.GET.get('title')
    # 获取列表类型参数（比如多选标签）
    tags = request.GET.getlist('tags')
    # 把QueryDict转成普通Python字典
    full_dict = request.GET.dict()
    print(full_dict)
    # 后续业务逻辑
    return render(request, 'listingpage.html')

注意事项 #

• 避免传递过大的字典：浏览器对URL长度有上限（一般2048字符左右），如果数据量较大，建议用POST请求或把数据存在Session/数据库中，只传递ID
• 敏感数据不要通过URL传递：URL参数会暴露在地址栏和日志中，敏感信息请用POST或加密处理

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