用途:该技能面向 TanStack Start 的中间件与服务端路由,帮助设计、实现、审查和调试相关代码。
主要能力与选择原则:先阅读 ../../docs/middleware-and-server-routes.md 以选择正确的管道。请求中间件用于包裹传入的 HTTP 请求与服务端路由;服务端函数中间件用于包裹应用 RPC;服务端路由用于公开 API、webhook、健康检查、feed 或自定义响应格式。
组合方式:显式组合中间件,记录中间件顺序及每层添加的上下文,通过 next 传递类型化上下文。来自客户端的上下文一律视为不可信,须在服务端校验;授权决策应靠近受保护资源。仅对全局生效的行为注册全局中间件,避免可变模块状态与层间隐藏依赖。
HTTP 契约:按需校验方法、参数、查询、请求头、请求体与内容类型,返回明确的状态码、响应头与响应体。检查动态、splat、转义、无路径布局及嵌套服务端路由的文件路由唯一性。
验证:测试执行顺序、上下文传播、短路行为、各支持的 HTTP 方法、非法请求体、状态码、响应头、认证、授权及全局中间件排除项;用真实 HTTP 路径验证外部调用方。最后报告中间件链、路由契约、错误行为与已运行的检查。
限制:资料未提供具体安装命令、版本要求或代码示例,相关细节暂未提供。