FastAPI从文件读取路径并通过**kwargs处理动态路径参数问题

需要从文件中读取路由路径（路径参数不固定），想用一个接受**kwargs的通用函数处理请求，但直接调用add_api_route会报错：

{"detail":[{"loc":["query","kwargs"],"msg":"field required","type":"value_error.missing"}]}

原因是FastAPI依赖函数签名识别路径参数，而**kwargs无法被自动解析。

解决方案一：通过Request对象获取路径参数 #

直接在处理函数中注入Request对象，手动提取所有路径参数，完全绕过函数签名的限制，适合任意动态路径：

from fastapi import APIRouter, Request

my_router = APIRouter()

def foo(request: Request):
    # 获取所有路径参数，返回字典格式
    path_params = request.path_params
    return {"Result": path_params.get("xyz")}

# 从文件读取的路径示例
read_from_file = "/foo/{xyz}"
my_router.add_api_route(read_from_file, endpoint=foo)

如果需要返回所有路径参数，直接返回path_params即可，不用关心具体参数名。

解决方案二：动态生成匹配路径的函数签名 #

如果必须保留**kwargs的函数形式，可以通过inspect模块动态修改函数签名，让FastAPI能识别路径中的参数：

from fastapi import APIRouter
import inspect

my_router = APIRouter()

def base_foo(**kwargs):
    return {"All Params": kwargs}

# 从文件读取的路径（支持多参数）
read_from_file = "/foo/{xyz}/{abc}"

# 提取路径中的参数名（比如['xyz', 'abc']）
path_param_names = [p.strip("{}") for p in read_from_file.split("/") if "{" in p]

# 生成新的函数签名：先添加路径参数，再保留**kwargs
original_sig = inspect.signature(base_foo)
new_params = [
    inspect.Parameter(name, inspect.Parameter.POSITIONAL_OR_KEYWORD)
    for name in path_param_names
]
new_params.append(inspect.Parameter("kwargs", inspect.Parameter.VAR_KEYWORD))
base_foo.__signature__ = original_sig.replace(parameters=new_params)

my_router.add_api_route(read_from_file, endpoint=base_foo)

解决方案三：接受任意子路径（通配符路由） #

如果不需要解析具体参数，只是想匹配/foo/之后的任意子路径，用FastAPI的path类型通配符即可：

from fastapi import APIRouter

my_router = APIRouter()

def foo(rest_of_path: str):
    return {"Full Subpath": rest_of_path}

# 匹配/foo/后的所有内容，比如/foo/abc/def/123都会被捕获
my_router.add_api_route("/foo/{rest_of_path:path}", endpoint=foo)

这种方式适合只需要获取完整子路径，不需要拆分参数的场景。

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