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)），进一步提升可测试性与可维护性。
