如何将Jinja2循环变量传递给Flask的路由函数？

方案1：URL路径参数（推荐，符合REST风格） #

Flask路由实现

@app.route('/view_document/<int:doc_id>')
def view_document(doc_id):
    # 替换为你的文档查询逻辑，比如从数据库按ID取文档
    target_doc = your_db_query_function(doc_id)
    return render_template('document_detail.html', doc=target_doc)

Jinja2模板写法

循环渲染文档列表时，直接用url_for生成带文档ID的跳转链接：

{% for doc in sorted_documents %}
<div class="doc-item">
    <h4><a href="{{ url_for('view_document', doc_id=doc.id) }}">{{ doc.title }}</a></h4>
    <p>{{ doc.preview_content }}</p>
</div>
{% endfor %}

url_for会自动拼接出类似/view_document/123的URL，Flask路由直接捕获doc_id参数，无需额外处理请求参数。

方案2：查询参数传递 #

如果偏好使用?形式的参数：

Flask路由实现

@app.route('/view_document')
def view_document():
    doc_id = request.args.get('doc_id')
    if not doc_id:
        # 参数缺失时的处理，比如跳转回列表页
        return redirect(url_for('doc_list_page'))
    target_doc = your_db_query_function(doc_id)
    return render_template('document_detail.html', doc=target_doc)

Jinja2模板写法

可以用a标签直接生成带参数的链接，或用表单提交（注意表单结构）：

{% for doc in sorted_documents %}
<div class="doc-item">
    <!-- 方式1：a标签直接跳转 -->
    <h4><a href="{{ url_for('view_document', doc_id=doc.id) }}">{{ doc.title }}</a></h4>
    <p>{{ doc.preview_content }}</p>

    <!-- 方式2：表单提交（适合按钮触发） -->
    <form action="{{ url_for('view_document') }}" method="GET">
        <input type="hidden" name="doc_id" value="{{ doc.id }}">
        <button type="submit">查看详情</button>
    </form>
</div>
{% endfor %}

注意：如果用表单提交，隐藏输入框必须放在<form>标签内部，否则参数不会被携带。

常见问题排查 #

• 确认Jinja2循环中doc对象的属性名正确（比如是doc.id还是doc.doc_id，要和后端数据结构一致）
• 用浏览器开发者工具查看生成的URL/表单数据，确认参数是否正确携带
• Flask路由的参数名称要和模板传递的完全匹配（比如模板传doc_id，路由就不能写成document_id）

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