FastAPI 查询参数处理：巧妙转换空字符串为 None
在使用 FastAPI 构建 API 接口时，处理查询参数 (query params) 至关重要。前端传递空字符串作为查询参数时，FastAPI 默认将其解析为空字符串，这可能导致类型校验失败，引发 422 错误。本文介绍一种优雅的方法，将 FastAPI 的查询参数中的空字符串转换为 None 值，避免此类问题。
假设我们有一个 API 接口，用于获取待审核列表，其查询参数包括时间范围和分数范围：
from fastapi import FastAPI, Depends, Queryfrom datetime import datetimefrom typing import Optionalapp = FastAPI()@app.get("/api/in_process/", summary="获取待审核列表")async def list_await_review( confirm_start: Optional[datetime] = Query(default=None), confirm_end: Optional[datetime] = Query(default=None), created_start: Optional[datetime] = Query(default=None), created_end: Optional[datetime] = Query(default=None), score_min: Optional[int] = Query(default=None), score_max: Optional[int] = Query(default=None),): # 处理查询逻辑 print(f"confirm_start: {confirm_start}") print(f"confirm_end: {confirm_end}") # ...其他参数 return {"message": "success"}
如果前端传递的 URL 参数类似 /api/in_process/?confirm_start=&confirm_end=&created_start=&created_end=&score_min=&score_max=，则 confirm_start、confirm_end 等参数将被解析为空字符串，而不是预期的 None。这将导致类型错误，因为 datetime 和 int 类型无法接收空字符串。
为了解决这个问题，我们可以利用 FastAPI 的 Query 参数的 default 属性和类型提示：
from fastapi import FastAPI, Depends, Queryfrom datetime import datetimefrom typing import Optionalapp = FastAPI()@app.get("/api/in_process/", summary="获取待审核列表")async def list_await_review( confirm_start: Optional[datetime] = Query(default=None), confirm_end: Optional[datetime] = Query(default=None), created_start: Optional[datetime] = Query(default=None), created_end: Optional[datetime] = Query(default=None), score_min: Optional[int] = Query(default=None), score_max: Optional[int] = Query(default=None),): # 处理查询逻辑 print(f"confirm_start: {confirm_start}") print(f"confirm_end: {confirm_end}") # ...其他参数 return {"message": "success"}
通过设置 default=None 并使用 Optional 类型提示，FastAPI 会自动将空字符串解析为 None 值。 这样，即使前端传递了空字符串，后端也能正确地将参数解析为 None，并进行后续处理，避免了 422 错误。 无需创建额外的依赖项函数。
这种方法简洁有效，充分利用了 FastAPI 内置的功能，推荐使用。
以上就是FastAPI中如何优雅地将空字符串查询参数转换为None？的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1359246.html
微信扫一扫 
支付宝扫一扫 
