SuperAPI AI 工具集

rust-web

编程与开发

查看项目

更新于 10-16 03:17

技能介绍

用途:在 Rust 中构建 Web 服务、REST API 或 HTTP 服务器时使用,覆盖 axum、actix-web、warp、rocket 等框架,以及 tower 中间件、hyper、reqwest HTTP 客户端。

主要能力与设计约束:强调无状态 HTTP(不使用请求级全局变量,状态放入提取器)、并发处理(异步与 Send + Sync)、延迟要求(高效所有权)、安全(输入校验与类型安全提取器)、可观测性(tracing 配合 tower 层)。

关键规则:处理器不得阻塞,阻塞一个任务会阻塞大量请求,CPU 工作用 spawn_blocking;共享状态必须线程安全,用 Arc<T>,可变状态用 Arc<RwLock<T>>;资源只在请求期间存活,用提取器管理所有权。

框架与常用 crate:axum 为函数式/tower 风格,适合现代 API;actix-web 基于 actor,追求高性能;warp 用过滤器组合;rocket 由宏驱动,适合快速开发。HTTP 服务端用 axum、actix-web,HTTP 客户端用 reqwest,JSON 用 serde_json,认证/JWT 用 jsonwebtoken,会话用 tower-sessions,数据库用 sqlx、diesel,中间件用 tower。

模式示例:提取器解析请求,如 State(db)、Json(payload);统一错误实现 IntoResponse;中间件用 tower 层;共享状态用 Arc<AppState>。处理器可返回 Result<Json<User>, AppError>,错误类型实现 IntoResponse 后映射为状态码与 JSON 错误体。

常见错误与修复:处理器内阻塞会导致延迟上升,改用 spawn_blocking;状态中用 Rc 不满足 Send + Sync,改用 Arc;缺少校验带来安全风险,改用类型安全提取器;缺少错误响应影响体验,实现 IntoResponse。

限制与补充:该资料未提供安装命令、版本要求、完整配置步骤或授权方式等信息,暂未提供;实际项目应结合具体框架文档确认细节。