Django POST表单未正确触发action，请求排查问题原因

我尝试创建一个使用method="POST"的简单搜索表单，通过action结合url标签指向目标视图URL以渲染结果模板，但表单无法正常工作：

• 提交后csrfmiddlewaretoken被附加到首页URL，表现得如同使用GET请求而非POST
• 改为GET方法、修改URL和视图均无效
• 移除CSRF后，首页URL仅添加?，完全未调用目标视图

相关代码 #

提交后跳转的URL

http://127.0.0.1:8000/bugtracker/?csrfmiddlewaretoken=jdGcvGb8pioQutLhDOL8y6zbK7DW6XSErTYQ8zHOI8W1fAXf8V6NFoFmzXRIvC3d&searched=

视图代码

@login_required(login_url='login_register')
def search_site(request):
    if request.method == "POST":
        searched = request.POST['searched']
        context = {
            'searched': searched
        }
        return render(request, 'bugs/search_site.html', context)
    else:
        return render(request, 'bugs/search_site.html')

URL配置

path('search_site/', views.search_site, name='search_site'),

搜索栏模板

<div class="input-group">
<form method="POST" action="{% url 'search_site' %}">
{% csrf_token %}
<input class="form-control" type="search" placeholder="Search for..." aria-label="Search for..." name="searched">
<button class="btn btn-primary" type="submit"><i class="fas fa-search"></i></button>
</form>
</div>

搜索结果模板

{% extends 'bugs/base.html' %}
{% block content %}
    <div class="container-fluid px-4">
        {% if searched %}
        <h4 class="mt-4">results for {{ searched }}</h4>
        {% endif %}

    </div>
{% endblock %}

排查与解决步骤 #

1. 检查URL命名空间
   如果你的Django app配置了app_name（比如app_name = 'bugs'），模板中调用URL时必须加上命名空间，否则会生成错误的URL导致提交到首页：

   <form method="POST" action="{% url 'bugs:search_site' %}">
   

2. 验证表单是否被嵌套或JS干扰

   • HTML不允许表单嵌套，检查页面中是否有父级表单将搜索表单包裹，导致提交行为被覆盖
   • 检查页面JS代码，确认没有阻止表单默认提交、修改method属性或篡改action地址的逻辑

3. 调试视图调用情况
   在视图中添加打印语句，确认视图是否被调用：

   @login_required(login_url='login_register')
   def search_site(request):
       print("search_site视图已触发")  # 控制台查看是否输出
       # 原有代码...
   

   同时可以暂时移除@login_required装饰器，排除未登录重定向的影响

4. 用浏览器开发者工具抓包分析
   打开F12进入「网络」面板，提交表单后查看：

   • 请求方法是否为POST
   • 请求地址是否为/search_site/
   • 响应状态码是否有重定向（比如302）

5. 优化表单数据获取方式
   避免直接用request.POST['searched']导致空提交时抛出KeyError，改用get方法：

   searched = request.POST.get('searched', '')
   

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