?

背景需求

在電商系統中，訂單管理模塊常需支持多維度組合查詢。典型篩選條件包括：

時間范圍：$t in [t_{text{start}}, t_{text{end}}]$

訂單狀態：$s in {text{待支付}, text{已發貨}, text{已完成}}$

金額區間：$p in [p_{min}, p_{max}]$

商品類別：$c = c_{text{target}}$

用戶ID：$u = u_{text{specified}}$

接口設計原則

RESTful風格
GET /orders?param1=value1?m2=value2

參數動態組合
支持任意條件自由組合，未傳參數視為不篩選

分頁機制
需包含page和size參數，避免全量查詢

核心實現方案

from flask import request
from sqlalchemy import and_

@app.route('/orders', methods=['GET'])
def filter_orders():
    # 解析查詢參數
    filters = []
    if 'start_time' in request.args:
        filters.append(Order.create_time >= request.args['start_time'])
    if 'end_time' in request.args:
        filters.append(Order.create_time <= request.args['end_time'])
    if 'status' in request.args:
        filters.append(Order.status == request.args['status'])
    # 其他條件類似處理...
    
    # 組合查詢與分頁
    query = Order.query.filter(and_(*filters)) if filters else Order.query
    page = query.paginate(page=int(request.args.get('page',1)), 
                          per_page=int(request.args.get('size',20)))
    return jsonify([order.to_dict() for order in page.items])

關鍵優化點

數據庫索引

為高頻篩選字段（如create_time, status）建立復合索引

滿足最左前綴原則：$ text{INDEX}(t,s) $

參數校驗

時間格式校驗：$text{ISO}8601$

枚舉值校驗：$s in S_{text{valid}}$

緩存策略

graph LR
A[請求] --> B{參數是否變化}
B -->|否| C[返回緩存結果]
B -->|是| D[數據庫查詢]
D --> E[更新緩存]

邊界處理

空結果集返回204 No Content

非法參數返回400 Bad Request并攜帶錯誤明細

大結果集強制分頁，默認限制$text{MAX_SIZE}=100$

總結

多條件篩選接口需平衡靈活性與性能，核心在于：

動態構建查詢條件

合理利用數據庫索引

規范化參數處理 通過分層設計可滿足復雜業務場景，同時保障系統穩定性。歡迎大家留言探討。

?審核編輯 黃宇