FastAPI：同一GET端点/Users能否接受两种不同参数类型？

你这种写法行不通，原因如下：

• 在FastAPI里，同一个路径+GET方法只能绑定一个处理函数，你写的第二个@app.get("/Users")会把第一个给覆盖掉，实际运行时只会生效最后那个函数。
• GET请求的参数是通过URL查询参数传递的，PersonInfo和CountryInfo都有id字段，另外分别带person和country，框架没法自动判断请求属于哪种类型，也就不知道该用哪个模型去解析参数。

给你两种可行的实现方式，不用改端点签名，只需要根据传入的参数区分处理：

方式一：直接判断参数字段 #

把所有可能的参数都列出来，然后在函数里判断传入的是person还是country：

from fastapi import FastAPI, HTTPException

class PersonInfo(AppUserInfo):
    id: int
    person: str

class CountryInfo(AppUserInfo):
    id: int
    country: str

@app.get("/Users")
def get_alias_api(id: int, person: str = None, country: str = None):
    # 校验参数合法性：不能同时传person和country，也不能都不传
    if person and country:
        raise HTTPException(status_code=400, detail="不能同时提供person和country参数")
    if not person and not country:
        raise HTTPException(status_code=400, detail="必须提供person或country其中一个参数")
    
    # 根据传入的参数生成对应实例
    if person:
        data = PersonInfo(id=id, person=person)
    else:
        data = CountryInfo(id=id, country=country)
    
    return {"data": data}

方式二：用Pydantic模型统一接收再转换 #

定义一个包含所有可选字段的父模型，接收参数后再转换成对应的子模型：

from fastapi import FastAPI, HTTPException
from pydantic import BaseModel, ValidationError

class PersonInfo(AppUserInfo):
    id: int
    person: str

class CountryInfo(AppUserInfo):
    id: int
    country: str

# 统一接收所有可能的查询参数
class UserQuery(BaseModel):
    id: int
    person: str = None
    country: str = None
    class Config:
        extra = "forbid"  # 禁止传入未定义的参数，避免非法参数

@app.get("/Users")
def get_alias_api(query: UserQuery):
    if query.person and query.country:
        raise HTTPException(status_code=400, detail="不能同时提供person和country参数")
    if not query.person and not query.country:
        raise HTTPException(status_code=400, detail="必须提供person或country其中一个参数")
    
    try:
        if query.person:
            data = PersonInfo(**query.dict(exclude_none=True))
        else:
            data = CountryInfo(**query.dict(exclude_none=True))
    except ValidationError as e:
        raise HTTPException(status_code=400, detail=f"参数格式错误：{str(e)}")
    
    return {"data": data}

核心思路就是：GET请求的查询参数没有类型标识，必须通过检查具体字段的存在性来区分请求类型，不能靠注册多个同路径的端点来实现。

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