萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網頁製作 >> HTML 腳本教學

Flask 獲取請求查詢參數:request.query_string 與 request.args 實戰

核心對象:request

Flask 的 request 對象封裝了當前 HTTP 請求的所有信息。獲取查詢字符串(URL ? 後部分)有兩種主流方式:

方式一:request.query_string — 原始字節串

from flask import Flask, request

app = Flask(__name__)

@app.route('/')
def index():
    qs = request.query_string        # 返回 bytes: b'name=foo&age=18'
    return f"Raw query string: {qs.decode()}"

if __name__ == '__main__':
    app.run(host='0.0.0.0', port=80)
  • 返回 bytes 類型,需 .decode() 轉字符串
  • 包含完整原始查詢字符串,未解析
  • 適用於需透傳/記錄原始 URL 參數的場景

方式二:request.args — 解析後的 MultiDict(推薦)

@app.route('/search')
def search():
    q = request.args.get('q', '')           # 單值,默認空串
    tags = request.args.getlist('tag')      # 多值列表
    page = request.args.get('page', 1, type=int)  # 類型轉換
    return f"Query: {q}, Tags: {tags}, Page: {page}"
  • 返回 MultiDict,鍵值均為字符串
  • 支持 get(key, default, type) 類型轉換
  • 支持 getlist(key) 獲取同名參數所有值
  • 自動處理 URL 解碼、多值、空值

對比速查

特性request.query_stringrequest.args
類型bytesMultiDict (dict-like)
解析狀態原始未解析已解析、解碼
多值支持需手動解析getlist() 原生支持
類型轉換手動type=int 內建
典型用途日誌記錄、透傳、簽名驗證業務邏輯提取參數

進階:獲取完整 URL 與路徑參數

  • request.full_path:包含查詢字符串的完整路徑(/path?k=v)
  • request.url:完整絕對 URL
  • request.view_args:路由變量(/user/<id> 中的 id)
copyright © 萬盛學電腦網 all rights reserved