退出函数返回None触发Pydantic类型错误的正确处理方案

你的接口通过response_model=DishSchedule明确指定了返回类型必须是DishSchedule实例，返回None会违反这个类型约束，导致Pydantic校验失败。正确的做法是当EVENTS为空时，抛出FastAPI的HTTPException返回错误响应，而不是返回None。

具体操作步骤 #

1. 先导入HTTPException：

from fastapi import HTTPException

2. 修改EVENTS为空的判断分支，替换return None为抛出异常：

# check to see if EVENTS is empty
if len(EVENTS) == 0:
    print("No EVENTS found!")
    raise HTTPException(status_code=400, detail="无法创建日程：当前无可用EVENTS")

为什么要这么做 #

• 抛出HTTPException后，FastAPI会自动返回标准的错误JSON响应（包含detail和status_code），同时直接终止函数执行，完全符合你“退出函数不返回有效内容”的需求。
• 这种方式遵循RESTful接口规范：创建操作失败时返回对应错误状态码（比如400表示请求的前置条件不满足），不会让调用方收到不符合约定的返回值。

如果非要允许返回None（不推荐，易造成接口语义混淆），可以修改返回类型约束：

from typing import Optional

@schedules_router.post("/schedules/", status_code=201, response_model=Optional[DishSchedule])
def create_schedule(*, schedule_in: CreateDishSchedule) -> Optional[DishSchedule]:
    # ... 原有代码 ...
    if len(EVENTS) == 0:
        print("No EVENTS found!")
        return None
    # ... 原有代码 ...

但这种方式会让接口返回201（创建成功状态码）却不带有效数据，容易误导调用方，所以优先推荐使用HTTPException的错误处理方式。

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