FastAPI视图间传递数据报错：NoMatchFound问题解决方法

问题场景 #

尝试在FastAPI两个视图间传递my_variable，后端代码如下：

from fastapi import APIRouter, Request, Response
from fastapi.templating import Jinja2Templates

templates = Jinja2Templates(directory="templates")
router = APIRouter()

@router.get("/my-first-view")
async def function1(request: Request) -> Response:
    """Display the home page."""
    my_variable = "some_value"  # 补充实际值，原代码的value未定义
    return templates.TemplateResponse(
        "home.jinja",
        context={
           "my_variable": my_variable
        },
    )

@router.get("/my-second-view")
async def function2(request: Request, my_variable: str) -> Response:
    """Display the variable processing page."""
    
    return templates.TemplateResponse(
        "page.jinja"
    )

模板home.jinja中通过url_for传递参数：

...
<a href="{{url_for('function2', my_variable=my_variable)}}" title="connect">Connect</a>
...

运行时触发错误：

starlette.routing.NoMatchFound: No route exists for name "function2" and params "my_variable".

问题根源与修正步骤 #

1. 路由名称匹配错误 #

使用APIRouter时，路由的完整名称格式为{router_name}:{endpoint_func_name}，默认router_name是api。直接用function2找不到对应路由，需修改模板中的url_for：

<a href="{{url_for('api:function2', my_variable=my_variable)}}" title="connect">Connect</a>

如果给router自定义了名称（如router = APIRouter(name="my_router")），则用url_for('my_router:function2', ...)。

2. 端点参数接收方式不明确 #

方式一：路径参数传递

若希望通过/my-second-view/{my_variable}的格式传递，修改function2的路由定义：

@router.get("/my-second-view/{my_variable}")
async def function2(request: Request, my_variable: str) -> Response:
    return templates.TemplateResponse(
        "page.jinja",
        context={"request": request, "my_variable": my_variable}
    )

方式二：查询参数传递

保持原路由/my-second-view不变，my_variable会自动作为查询参数（URL格式为/my-second-view?my_variable=xxx），但需确保function2的TemplateResponse传入必要的context。

3. 补充TemplateResponse的必填参数 #

Jinja2模板的TemplateResponse必须传入request对象，同时需要将传递的变量传入context供模板使用，修正两处返回逻辑：

• function1的TemplateResponse补充request到context：

return templates.TemplateResponse(
    "home.jinja",
    context={
       "request": request,
       "my_variable": my_variable
    },
)

• function2的TemplateResponse补充context：

return templates.TemplateResponse(
    "page.jinja",
    context={"request": request, "my_variable": my_variable}
)

其他视图间数据传递方案 #

除了URL参数传递，还可以根据场景选择以下方式：

• Session/Cookie：适合用户会话类数据，通过Starlette的SessionMiddleware实现。
• 依赖注入：请求级或全局共享数据，使用FastAPI的依赖项定义共享逻辑。
• 数据库/缓存：跨请求持久化数据，存入数据库或Redis等中间件。

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