fastapi 不支持直接用依赖项覆盖路径参数，但可通过 `optional[str]` 参数 + 请求路径判断实现统一处理逻辑：对 `/outbound/{wako_id}` 自动提取路径值，对 `/inbound` 则由依赖项提供默认 id。
在 FastAPI 中，路径参数（如 /outbound/{wako_id}）是强制性的，无法设为可选；而依赖项（Depends）本身不能“注入”到路径参数占位符中——它只能作为函数参数被解析。因此，若希望同一处理函数既能接收显式路径参数、又能由依赖项提供默认值，关键在于解耦参数来源：将 wako_id 声明为可选依赖参数，并在依赖函数内根据当前请求的实际路径动态决定其值。
以下是一个健壮、可复用的实现方案：
from fastapi import FastAPI, Request, Depends, APIRouter from typing import Optional app = FastAPI() router = APIRouter() def get_wako_id(request: Request, wako_id: Optional[str] = None) -> str: """ 统一获取 wako_id 的依赖函数： - 若请求路径为 '/outbound/{wako_id}' 且路径中已匹配到 wako_id，则返回该值； - 若请求路径为 '/inbound'，则返回硬编码默认值 '123'； - 其他路径将触发 400 错误（可按需调整）。 """ # 获取当前路由的原始路径模板（含 {param} 占位符） route_path = request.scope.get("route", {}).get("path", "") if route_path == "/outbound/{wako_id}" and wako_id is not None: return wako_id elif route_path == "/inbound": return "123" else: from fastapi import HTTPException raise HTTPException( status_code=400, detail=f"Unsupported route or missing wako_id: {route_path}" ) @router.get("/inbound") @router.get("/outbound/{wako_id}") def handle_request(wako_id: str = Depends(get_wako_id)): return {"wako_id": wako_id} app.include_router(router)✅ 关键要点说明：
- 使用 Optional[str] = None 作为依赖函数参数，使 FastAPI 在 /outbound/{wako_id} 路由中自动注入路径值，在 /inbound 中传入 None，从而进入分支逻辑；
- 通过 request.scope[“route”].path 获取路由定义的原始路径模板（非请求 URL），确保判断稳定可靠（避免因前缀、代理等导致的路径变形）；
- 不建议依赖 request.url.path —— 它返回的是实际请求路径（如 /inbound），无法区分 /outbound/abc 和 /outbound/xyz 的共性模板，而 route.path 才反映开发者定义的路径结构；
- 路径参数天然强制校验：若访问 /outbound（无 ID），FastAPI 会提前返回 404 Not Found，无需在依赖中重复校验；
- 错误处理应使用 HTTPException 而非 jsONResponse，以保持 FastAPI 的异常处理链（如自动生成 OpenAPI 错误文档、中间件拦截等）。
? 进阶提示：
如需支持更多路由或动态默认值（如从数据库/配置加载），可将默认 ID 提取为依赖参数（例如 default_id: str = Depends(get_default_id)），进一步提升可测试性与可维护性。