FastAPI GET路由返回必填字段缺失错误，如何解决？

1. 直接解决调用报错的问题 #

错误提示明确说明查询参数url、username、password缺失，调用接口时必须通过查询参数传递这些值：

• 正确的请求URL示例：

  http://your-server-ip:port/connect?url=http://target-url&username=your-username&password=your-password
  

• 如果用FastAPI自带的/docs页面（Swagger UI），直接在页面上填写这三个参数后点击执行即可。

2. 修复代码逻辑的冗余问题 #

你的代码里存在无效逻辑：函数接收参数后立刻用硬编码值覆盖，等于接口参数完全没起到作用。根据需求分两种情况处理：

情况一：需要接收外部传入的参数（正常业务场景） #

删除硬编码赋值的行，直接使用传入的参数：

from fastapi import FastAPI
import json
# 确保Connector类已正确导入
from your_module import Connector

app = FastAPI()  # 注意：原代码漏了初始化FastAPI实例

@app.get("/connect")
async def files_info(url: str, username: str, password: str):
    conn = Connector(url, username, password)
    # 建议直接返回字典，FastAPI会自动序列化为JSON，比手动json.dumps更规范
    return conn.get_files_info("")

情况二：仅用于测试，不想传参数（硬编码固定值） #

如果只是测试，可以给参数设置默认值，这样调用时即使不传参数也不会报错：

from fastapi import FastAPI
import json
from your_module import Connector

app = FastAPI()

@app.get("/connect")
async def files_info(
    url: str = "http://your-test-url",  # 设置默认值
    username: str = "test-username",
    password: str = "test-password"
):
    conn = Connector(url, username, password)
    return conn.get_files_info("")

3. 额外代码优化建议 #

• 不要手动使用json.dumps返回字符串，FastAPI会自动将Python字典/对象序列化为JSON响应，更符合框架规范。
• 确保已初始化FastAPI实例（app = FastAPI()），原代码漏掉了这一行，否则路由无法生效。
• 如果使用test_url变量，需要提前定义它的具体值，否则会报未定义错误。

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