?

背景需求

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

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

訂單狀態(tài)：$s in {text{待支付}, text{已發(fā)貨}, text{已完成}}$

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

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

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

接口設(shè)計(jì)原則

RESTful風(fēng)格
GET /orders?param1=value1?m2=value2

參數(shù)動(dòng)態(tài)組合
支持任意條件自由組合，未傳參數(shù)視為不篩選

分頁(yè)機(jī)制
需包含page和size參數(shù)，避免全量查詢

核心實(shí)現(xiàn)方案

from flask import request
from sqlalchemy import and_

@app.route('/orders', methods=['GET'])
def filter_orders():
    # 解析查詢參數(shù)
    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'])
    # 其他條件類似處理...
    
    # 組合查詢與分頁(yè)
    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])

關(guān)鍵優(yōu)化點(diǎn)

數(shù)據(jù)庫(kù)索引

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

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

參數(shù)校驗(yàn)

時(shí)間格式校驗(yàn)：$text{ISO}8601$

枚舉值校驗(yàn)：$s in S_{text{valid}}$

緩存策略

graph LR
A[請(qǐng)求] --> B{參數(shù)是否變化}
B -->|否| C[返回緩存結(jié)果]
B -->|是| D[數(shù)據(jù)庫(kù)查詢]
D --> E[更新緩存]

邊界處理

空結(jié)果集返回204 No Content

非法參數(shù)返回400 Bad Request并攜帶錯(cuò)誤明細(xì)

大結(jié)果集強(qiáng)制分頁(yè)，默認(rèn)限制$text{MAX_SIZE}=100$

總結(jié)

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

動(dòng)態(tài)構(gòu)建查詢條件

合理利用數(shù)據(jù)庫(kù)索引

規(guī)范化參數(shù)處理 通過(guò)分層設(shè)計(jì)可滿足復(fù)雜業(yè)務(wù)場(chǎng)景，同時(shí)保障系統(tǒng)穩(wěn)定性。歡迎大家留言探討。

?審核編輯 黃宇