如何解决 Flask 表单提交不触发 POST 请求的问题

在 Flask 开发中，一个常见却容易被忽略的问题是：表单点击提交后，页面 URL 发生变化（如追加查询参数 ?query=xxx），但后端视图函数中的 request.method == 'POST' 分支从未执行——这意味着请求实际是以 GET 方式发出的，而非预期的 POST。

根本原因在于：HTML

✅ 正确做法是：
在表单标签中显式添加 method="POST"，并确保 action 指向正确端点（若为空或省略，则默认提交至当前 URL）：

<form method="POST" class="form-inline my-2 my-lg-0">
    <input class="form-control mr-sm-2" 
           type="search" 
           placeholder="Search" 
           id="query" 
           name="query" />
    <button class="btn btn-outline-primary my-2 my-sm-0" type="submit">
        <i class="bi bi-search"></i>
    </button>
</form>

同时，后端路由需保持对 POST 的支持（你已正确配置）：

Genspark

Genspark 是一款创新的 AI 搜索引擎，致力于提供比传统搜索引擎更高效、准确和无偏见的信息获取方式。

下载

@auth.route('/search', methods=['GET', 'POST'])
def search():
    if request.method == 'POST':
        query_name = request.form.get('query')  # ✅ 现在可正常获取 POST 数据
        if query_name:
            results = Edetails.query.filter(Edetails.name.icontains(query_name)).all()
            return render_template('search.html', results=results, user=current_user)
        else:
            # 可选：空搜索处理
            return render_template('search.html', results=[], user=current_user)

    # GET 请求：首次访问或重定向后展示空页
    return render_template("search.html", user=current_user)

⚠️ 注意事项：

• 不要依赖 request.args.get('query') 处理该表单——那是 GET 提交的行为，与本意相悖；
• 若需 CSRF 保护（生产环境强烈推荐），请在表单中加入 {{ csrf_token() }}（配合 Flask-WTF）；
• 确保模板中 url_for('auth.search') 用于 action 属性时路径准确，避免因路由错位导致 404 或方法不匹配；
• 浏览器开发者工具的 Network 标签页可直观验证请求 Method 是 POST 还是 GET，是调试此类问题的第一步。

总结：HTML 表单的 method 属性不是可选项，而是决定请求语义的关键声明。在 Flask 中实现真正的 POST 提交，