FastAPI循环创建端点：Python异步函数作用域匹配外部作用域方案

问题原因 #

这是Python闭包的延迟绑定特性导致的：循环中定义的异步函数validate_item作为闭包，引用的title_name和model变量并不会在函数定义时固定值，而是在函数被调用时才去查找变量的当前值。循环结束后，这些变量都保留了最后一次迭代的赋值，所以所有端点调用时都会使用BarModel对应的title_name。

解决方案 #

方法1：用函数默认参数捕获当前值 #

默认参数会在函数定义时求值并固定，因此可以把需要保留的变量作为默认参数传入函数：

my_models = [
    ("FooModel", FooModel),
    ("BarModel", BarModel),
]

app = FastAPI()

for name, model in my_models:
    snake_name = utils.camel_to_snake(name)
    title_name = utils.camel_to_title(name)

    @app.post(
        f"/{snake_name}",
        response_model=model,
        name=f"{title_name} Create",
    )
    async def validate_item(item: model, request: Request, title_name=title_name):
        logger.info(
            f"[Valid] {request.method} {title_name} ID: {item.identifier()}"
        )
        return item

这里title_name=title_name会在每次循环迭代时，把当前的变量值绑定为函数的默认参数，后续调用时就会使用这个固定值。

方法2：使用工厂函数创建闭包 #

写一个外层工厂函数，接收需要固定的变量，返回对应的处理函数，这样每个函数都会捕获各自迭代的变量值：

my_models = [
    ("FooModel", FooModel),
    ("BarModel", BarModel),
]

app = FastAPI()

def create_validation_endpoint(title_name, model):
    async def validate_item(item: model, request: Request):
        logger.info(
            f"[Valid] {request.method} {title_name} ID: {item.identifier()}"
        )
        return item
    return validate_item

for name, model in my_models:
    snake_name = utils.camel_to_snake(name)
    title_name = utils.camel_to_title(name)

    validate_func = create_validation_endpoint(title_name, model)
    app.post(
        f"/{snake_name}",
        response_model=model,
        name=f"{title_name} Create",
    )(validate_func)

这种方式更清晰，能明确隔离每个端点的变量作用域，彻底避免闭包绑定问题。

关于model参数的问题 #

是的，签名中的model同样存在闭包延迟绑定问题。如果不做处理，所有端点的item参数最终都会被解析为循环最后一次的BarModel。上述两种解决方案也同时解决了model的绑定问题，确保每个端点的请求体都对应正确的模型。

另外需要注意：@app.post装饰器中的response_model=model是在循环迭代时直接求值的，所以原本就可以正确绑定当前的模型，不会有问题。

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