FastAPI如何设置路由函数参数类型与导入方法参数类型一致

不需要用exec做字符串拼接，利用Python标准库的内省能力 + FastAPI的路由注册逻辑就能实现，完全符合Python编码规范，安全风险也低得多。

核心原理 #

FastAPI生成OpenAPI schema、做参数解析校验的核心依据，是路由处理函数的类型注解和函数签名——这两类信息在Python中都是运行时可读取、可修改的元数据，不需要提前硬编码。你只需要在服务启动阶段读取客户代码中foo函数的元数据，动态构造和foo签名完全一致的路由处理函数，再注册到FastAPI实例上即可，效果和手写路由函数完全一致。

具体实现代码 #

你可以直接把main.py的逻辑改成如下形式：

import inspect
from functools import wraps
from fastapi import FastAPI
from customer_code import blah

app = FastAPI()

# 读取客户提供的目标函数
target_func = blah.foo
# 获取函数完整签名（包含参数名、类型、默认值等所有信息）
target_sig = inspect.signature(target_func)

@wraps(target_func)
def wrapper(**kwargs):
    # FastAPI会自动完成参数解析、Pydantic校验，这里直接透传给客户函数即可
    return target_func(**kwargs)

# 把客户函数的类型注解完整复制给包装函数
wrapper.__annotations__ = target_func.__annotations__.copy()
# 把客户函数的签名完整绑定给包装函数，保证FastAPI能读取到完整参数信息
wrapper.__signature__ = target_sig

# 动态注册路由，不需要提前写死bar函数
app.add_api_route(
    path="/do_something",
    endpoint=wrapper,
    methods=["POST"],
    # 可选：直接把客户函数的docstring作为接口描述
    description=target_func.__doc__
)

方案优势 #

• 无exec/eval类动态代码执行逻辑，安全风险更低，不需要额外处理字符串注入问题，仅需要做好客户代码导入的沙箱隔离即可。
• 完全兼容FastAPI的所有参数类型：不管客户函数里用的是Pydantic请求体、查询参数、路径参数、Header/Cookie参数，还是其他FastAPI支持的注解形式，都能自动识别，OpenAPI文档生成、参数校验逻辑和手写路由完全一致。
• 自动适配同步/异步函数：如果客户的foo是同步函数，FastAPI会自动按照同步路由的逻辑放到线程池执行，和原生路由行为没有差异。
• 扩展性强：如果需要挂载多个客户函数，只需要遍历所有目标函数，重复上述签名复制、路由注册的流程即可，不需要为每个函数单独写适配逻辑。

注意事项 #

如果需要做严格的参数校验，可以在复制注解前加一层检查，过滤掉FastAPI/Pydantic不支持的类型，避免服务启动时报错。

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