FastAPI中Request.query_params无法返回所有查询值的问题咨询

这不是Bug，属于有意设计的行为。req.query_params本质是Starlette的QueryParams对象，它的默认取值逻辑是返回重复参数的最后一个值，这是为了兼容大多数单值查询参数的常规使用场景，和很多Web框架的处理方式保持一致。

要获取重复查询参数的所有值，有两种直接的方法：

方法1：使用getlist方法 #

QueryParams提供了getlist(key)方法，专门用于获取指定键对应的所有参数值，返回一个列表：

from fastapi import FastAPI, Request, Query
from typing import List

app = FastAPI()

@app.get("/test")
async def test(req: Request, q:List[str] = Query(None)):
    all_q = req.query_params.getlist("q")
    return {"all_q_values": all_q}

当请求/test?q=foo&q=bar&q=baz时，返回结果会是{"all_q_values": ["foo", "bar", "baz"]}。

方法2：使用multi_items()方法 #

如果需要获取所有查询参数（包括重复键的所有实例），可以调用multi_items()，它会返回一个包含所有键值对的迭代器：

@app.get("/test")
async def test(req: Request, q:List[str] = Query(None)):
    all_params = list(req.query_params.multi_items())
    return {"all_params": all_params}

同样请求/test?q=foo&q=bar&q=baz时，返回结果会是{"all_params": [("q", "foo"), ("q", "bar"), ("q", "baz")]}。

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