Django如何通过URL查询参数传参 避免配置复杂URL路由模式

你完全不需要在路由层做特殊的参数捕获配置，Django的路由系统本身就只匹配?之前的路径部分，?之后拼接的查询参数不会参与路由匹配，一条最基础的静态路由就能覆盖所有参数数量、顺序不固定的场景。

具体配置方法 #

1. 配置单条路由即可 #

不需要写任何路径参数占位符，也不需要自定义什么参数字典转换器，直接在urls.py里写静态路径映射：

from django.urls import path
from . import views

urlpatterns = [
    # 仅匹配/page/路径，所有带查询参数的同路径请求全都会进入这个视图
    path('page/', views.page, name='page'),
]

注意路径末尾的斜杠不要漏写，避免触发Django默认的斜杠重定向逻辑。

2. 视图层直接读取解析好的查询参数 #

Django会自动把URL中?后的查询字符串解析成类字典对象，挂在request.GET属性上，直接按需取值即可：

from django.http import HttpResponse

def page(request):
    # 推荐用get方法取值，参数不存在时不会抛出KeyError，可自定义默认值
    page_id = request.GET.get('id')
    color = request.GET.get('color', '')
    animal = request.GET.get('animal', '')
    country = request.GET.get('country', '')
    name = request.GET.get('name', '')

    # 按需做参数校验即可，比如id是必填数字的场景
    if not page_id:
        return HttpResponse("缺少必填参数id", status=400)
    try:
        page_id = int(page_id)
    except ValueError:
        return HttpResponse("id参数必须为合法数字", status=400)

    # 正常写业务逻辑即可
    return HttpResponse(f"页面加载成功，id：{page_id}")

效果说明 #

配置完成后，以下所有URL都会自动匹配到同一个视图，不需要额外加路由规则：

• example.com/page?id=12&animal=dog&country=Japan&name=spot
• example.com/page?id=12&color=red&animal=dog&name=spot
• example.com/page?id=12&country=Japan&color=red&animal=dog&name=spot

后续如果需要新增、删除参数，完全不需要修改路由配置，直接在视图里从request.GET读取对应参数即可。

补充说明：路径参数（即/page/12/red/这种嵌在路径层级里的参数）天生适合资源定位场景，要求参数顺序、数量固定；而多可选参数、筛选类的灵活传参场景，本身就应该用查询参数实现，这是HTTP的标准用法，完全不需要为了适配灵活参数写大量重复路由。

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