FastAPI中解析用逗号分隔的多个Query参数的方法

在FastAPI的开发过程中，经常会遇到需要解析用逗号分隔的多个Query参数的情况。这种需求在许多场景下都非常实用，比如根据多个标签筛选数据等。下面将详细介绍在FastAPI中实现这一功能的方法。

明确Query参数的概念。Query参数是在URL中通过问号（?）后面跟随键值对的形式传递的参数。当需要传递多个值时，一种常见的方式是将这些值用逗号分隔。

在FastAPI中，可以使用 Query 类来处理这种情况。假设我们要接收一个名为 tags 的Query参数，它可能包含多个用逗号分隔的值。以下是一个简单的示例代码：

from fastapi import FastAPI, Query

app = FastAPI()

@app.get("/items/")
async def read_items(tags: str = Query(None)):
    if tags:
        tag_list = tags.split(",")
        return {"tags": tag_list}
    else:
        return {"tags": []}

在上述代码中，我们定义了一个名为 read_items 的路由处理函数，它接收一个可选的 tags 参数。如果 tags 参数存在，我们使用 split 方法将其按逗号分隔成一个列表。

还可以添加一些验证逻辑。例如，限制 tags 参数的最大长度，或者确保每个标签都符合特定的格式。可以使用 Query 类的参数来实现这些验证：

@app.get("/items/")
async def read_items(tags: str = Query(None, max_length=50)):
    # 这里添加验证逻辑
    if tags:
        tag_list = tags.split(",")
        for tag in tag_list:
            if not tag.isalnum():
                return {"error": "标签必须是字母数字组合"}
        return {"tags": tag_list}
    else:
        return {"tags": []}

这样，我们就可以在FastAPI中有效地解析用逗号分隔的多个Query参数了。通过合理运用 Query 类和相关的验证机制，能够确保接收到的参数符合我们的预期，提高应用程序的稳定性和安全性。在实际开发中，根据具体的业务需求，还可以进一步扩展和优化这个功能，以满足各种复杂的场景。