如何解决FastAPI动态创建Pydantic模型路由时的覆盖问题？

问题背景 #

在通过循环为Pydantic模型列表创建GET端点时，所有路由最终都会返回最后一个模型的响应（比如调用/thing却返回/other的结果）。你的简化代码如下：

# models.py
class Thing(BaseNode):
    value: str

class Other(BaseNode):
    value: str

model_list = [Thing, Other]

# app.py
from models import model_list
from fastapi import FastAPI

app = FastAPI()

# 遍历模型列表定义get函数
for model in model_list:
    @app.get(f"/{model.__name__.lower()}")
    def get() -> str:
         print(model.__name__)
         return f"Getting {model.__name__}"

问题原因 #

这是Python闭包的延迟绑定特性导致的，和FastAPI本身无关。循环中定义的get函数会引用循环变量model，但这个变量的取值是在函数实际调用时才确定的。当循环结束后，model指向列表的最后一个元素（也就是Other），所以所有路由的处理器函数执行时都会使用这个最后一个模型。

解决方法 #

方法1：嵌套函数捕获当前模型（你发现的可行写法） #

这种方式通过外层函数将当前循环的model作为参数传入，内层的_get函数会捕获这个参数的当前值，避免了延迟绑定的问题。可以稍微优化写法让逻辑更清晰：

from models import model_list
from fastapi import FastAPI

app = FastAPI()

for model in model_list:
    def create_endpoint(current_model):
        def _get():
            print(f"Getting {current_model.__name__}")
            return f"Getting {current_model.__name__}"
        return _get

    app.get(f"/{model.__name__.lower()}", name=f"{model.__name__}.View")(create_endpoint(model))

方法2：用functools.partial简化代码 #

如果不想写嵌套函数，可以用functools.partial固定函数参数，直接绑定当前循环的模型：

from models import model_list
from fastapi import FastAPI
from functools import partial

app = FastAPI()

def get_model(current_model):
    print(f"Getting {current_model.__name__}")
    return f"Getting {current_model.__name__}"

for model in model_list:
    endpoint = partial(get_model, current_model=model)
    app.get(f"/{model.__name__.lower()}", name=f"{model.__name__}.View")(endpoint)

方法3：lambda函数加默认参数 #

另一种简洁的方式是利用lambda的默认参数绑定当前值，避免延迟绑定问题：

from models import model_list
from fastapi import FastAPI

app = FastAPI()

for model in model_list:
    app.get(f"/{model.__name__.lower()}", name=f"{model.__name__}.View")(
        lambda current_model=model: f"Getting {current_model.__name__}"
    )

验证方式 #

启动服务后，分别访问/thing和/other，会看到各自返回对应模型的名称，说明路由已正常绑定，没有被覆盖。

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