You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

使用Query传递多URL输入时字段显示"string",期望为空的问题

解决Swagger UI中多URL Query字段默认显示"string"的问题

swagger UI

你遇到的是FastAPI中Swagger UI对列表类型Query参数默认展示示例文本的问题。仅用Query(default=None)无法改变Swagger的默认示例显示逻辑,要让输入字段为空,只需在Query参数中添加example=[],强制指定空列表作为示例:

from typing import Optional, List
from fastapi import Query

def Input_Multiple_URLs(mutiple_input_urls: Optional[List[str]] = Query(default=None, example=[])):
    # 你的业务代码
    return {"received_urls": mutiple_input_urls}

如果希望完全移除示例文本,也可以设置example=None,不过部分Swagger版本可能仍会保留占位提示,用example=[]的兼容性更好。修改后Swagger UI中的输入框就会显示为空,符合预期。

内容的提问来源于stack exchange,提问作者Anil Kumar

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.14 12:51:08