FastAPI 如何动态生成可通过配置启停的子API模块

AI 小北

2026-9-29

问题原因

第一个问题是Python闭包的晚绑定特性：循环内定义的read_sub函数只有被调用时才会读取变量x的值，此时循环已执行完成，x固定为最后一次迭代生成的FastAPI实例，导致所有子接口返回内容一致。
第二个问题是root_path不会被自动赋值：调用app.mount()时不会自动将挂载路径同步到子FastAPI实例的root_path属性，需要手动显式传入。

可行解决方案

采用工厂函数封装子API的创建逻辑，将每次迭代的路径参数隔离在独立的函数作用域内，同时显式为子FastAPI实例传入root_path，实现完全符合预期的效果。

实现代码

from fastapi import FastAPI

app = FastAPI()

@app.get("/app")
def read_main():
    return {"message": "Hello World from main app"}

# 子API工厂函数，每次调用生成独立的子API实例
def create_sub_api(mount_path: str) -> FastAPI:
    # 显式传入root_path
    sub_api = FastAPI(root_path=mount_path)
    # 路径前缀直接从当前函数作用域的mount_path获取，不受后续迭代影响
    @sub_api.get("/sub")
    def read_sub():
        module_name = mount_path.lstrip("/")
        return {"message": f"Hello World from the {module_name} sub API"}
    # 可以在这里为不同子API扩展专属的路由、中间件、依赖等
    return sub_api

endpoints = ['subapi1', 'subapi2', 'somethingelse']

for endpoint in endpoints:
    mount_path = f"/{endpoint}"
    sub_api = create_sub_api(mount_path)
    app.mount(mount_path, sub_api)

效果验证

调用对应接口即可返回预期结果：

GET /subapi1/sub 返回 {"message": "Hello World from the subapi1 sub API"}
GET /subapi2/sub 返回 {"message": "Hello World from the subapi2 sub API"}
GET /somethingelse/sub 返回 {"message": "Hello World from the somethingelse sub API"}