FastAPI中组合依赖实现嵌套模型遇加载过长问题求助

你的实现存在几个关键问题，导致Swagger Docs加载异常：

1. 参数传递方式错误 #

你定义的car_params和motor_params依赖中的参数，会被FastAPI默认解析为查询参数（POST接口的普通类型参数默认走Query），而非请求体里的嵌套结构。这会让Swagger Docs中出现4个平铺的可选参数，完全偏离你想要的"嵌套模型"需求，同时可能导致Schema解析逻辑混乱，引发加载缓慢。

2. 未用Pydantic定义结构化模型 #

直接用字典返回依赖结果，FastAPI无法生成清晰的OpenAPI Schema。Swagger在解析模糊的Schema时，容易出现逻辑阻塞，导致页面加载超时。

3. 依赖判断逻辑不严谨 #

if not car的判断仅当name和brand都不传时才会返回motor，但只要其中一个参数有值，car就不是空字典，会直接返回car。这种逻辑无法实现"二选一"的嵌套模型效果。

正确实现方式（基于Pydantic嵌套模型） #

使用Pydantic定义结构化模型，让FastAPI能正确生成Schema，同时实现"二选一"的嵌套结构：

步骤1：定义Pydantic模型 #

from pydantic import BaseModel
from typing import Annotated, Union
from fastapi import FastAPI, Body, HTTPException

app = FastAPI()

class Car(BaseModel):
    name: str | None = None
    brand: str | None = None
    type: str = "car"  # 用于区分不同模型的标识字段

class Motor(BaseModel):
    name_m: str | None = None
    brand_m: str | None = None
    type: str = "motor"  # 用于区分不同模型的标识字段

步骤2：使用Union模型+鉴别器实现二选一 #

通过discriminator让Swagger支持选择不同的嵌套模型，保证请求体结构清晰：

@app.post("/cardetail/3")
def get_car(
    info: Annotated[Union[Car, Motor], Body(..., discriminator="type")]
):
    return info.dict()

替代方案（基于依赖组合） #

如果坚持用依赖组合的方式，可修改为基于模型的依赖：

from fastapi import Depends

def get_car_model(car: Car = Depends()):
    return car

def get_motor_model(motor: Motor = Depends()):
    return motor

def transport_param(
    car: Annotated[Car, Depends(get_car_model)] = None,
    motor: Annotated[Motor, Depends(get_motor_model)] = None
):
    car_has_data = any(v is not None for v in car.dict().values()) if car else False
    motor_has_data = any(v is not None for v in motor.dict().values()) if motor else False

    if car_has_data and motor_has_data:
        raise HTTPException(status_code=400, detail="只能传入car或motor其中一组参数")
    elif car_has_data:
        return car.dict()
    elif motor_has_data:
        return motor.dict()
    else:
        raise HTTPException(status_code=400, detail="请传入car或motor参数")

@app.post("/cardetail/3")
def get_car(
    info: Annotated[dict, Depends(transport_param)]
):
    return info

效果说明 #

修改后，Swagger Docs会正确显示嵌套模型的选择界面，不会出现加载缓慢的问题，同时严格实现了"二选一"的嵌套参数逻辑。

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