从 Actix-web 迁移到 Salvo：Rust Web 开发效率提升实践

相比传统方式需要手动解析请求体、处理错误状态和生成 Token，Salvo 让业务逻辑更加聚焦。

3. 参数提取：类型安全与自动解析

利用 #[derive(Extractible)] 特性，Salvo 支持自动解析请求参数，包括 Body、Query 和 Header。

#[derive(Extractible)]
struct CreateUserRequest {
    #[extract(source = "body")]
    username: String,
    
    #[extract(source = "query")]
    role: Option<String>,
    
    #[extract(source = "header")]
    token: String,
}

#[handler]
async fn create_user(req: CreateUserRequest) -> Json<User> {
    let user = User::new(req.username, req.role.unwrap_or_default());
    Json(user_repository.save(user))
}

这种方式在编译期即可校验参数类型，大幅减少了运行时验证代码，降低了因参数缺失导致的错误风险。

二、性能表现：速度与资源优化

1. 基准测试对比

通过 wrk 工具进行压力测试，Salvo 在高并发场景下表现出较好的吞吐量。

• Salvo：QPS 约 12.5 万，内存占用 8.2MB，平均延迟 0.8ms
• Actix-web：QPS 约 9.8 万，内存占用 15.6MB，平均延迟 1.2ms

在极端场景下，如上传大文件，Salvo 的流式处理能力能有效控制内存峰值，避免 OOM 问题。

2. 编译速度

对于包含多个接口的项目，编译时间直接影响开发迭代效率。Salvo 的编译速度通常快于 Actix-web，这得益于其更轻量的依赖结构和构建优化。在频繁修改代码的场景下，缩短等待时间有助于保持开发思路的连贯性。

3. 生产环境数据

在某电商中台改造项目中，迁移后的指标变化如下：

团队反馈显示，新框架显著提升了迭代速度，并允许在更短时间内集成限流等中间件功能。

三、维护成本：轻量化与模块化

1. 依赖管理

Actix-web 生态庞大，涉及多个子库（如 actix-rt, actix-files 等），版本兼容性有时会带来困扰。Salvo 核心依赖较少，主要围绕 salvo, tokio, hyper，升级和维护更为轻松。

2. 中间件机制

Actix-web 使用 wrap 链式调用，顺序敏感，配置不当可能导致日志或鉴权失效。Salvo 采用 .hoop() 方法，中间件挂载逻辑清晰，类似装饰器模式，易于理解和扩展。

let router = Router::new()
    .hoop(Logger::new())      // 日志中间件
    .hoop(AuthMiddleware)     // 鉴权中间件
    .get("/", hello);

3. 数据库集成

Salvo 通过扩展支持 ORM 集成，如 salvo_diesel。数据库连接可注入 Handler，参数自动解析，减少了手动管理连接池的代码量。

#[handler]
async fn list_users(conn: DieselHandler<DbConnection>) -> Json<Vec<User>> {
    users::table.load(&conn.0).unwrap()
}

这种方式简化了数据访问层的编写，同时保证了异步查询的安全性。

四、工具链与调试体验

1. IDE 支持

VSCode 等编辑器对 Salvo 提供了较好的代码补全支持。输入 #[handler] 后，IDE 能自动提示处理器名称、参数类型及返回类型，减少记忆负担。

2. 自动化生成

Salvo 提供 CLI 工具辅助生成 CRUD 接口，例如：

# 生成用户增删改查接口
salvo generate crud User --fields "id:u64 name:String email:String"

该命令会自动生成包含参数验证、数据库操作及错误处理的完整代码骨架。

3. 日志追踪

结合 tracing crate，可以轻松实现接口耗时统计和链路追踪。

#[handler]
async fn tracked_handler(req: &mut Request) {
    tracing::info!("进入接口：{}", req.uri());
    let start = Instant::now();
    
    // 业务逻辑...
    
    tracing::info!("处理耗时：{:?}", start.elapsed());
}

五、WebSocket 实战

Salvo 对 WebSocket 的支持同样简洁，无需复杂配置即可完成连接升级。

#[handler]
async fn chat_ws(req: &mut Request, res: &mut Response) {
    WebSocketUpgrade::new()
        .on_upgrade(|ws| handle_socket(ws))
        .upgrade(req, res)
        .await;
}

async fn handle_socket(mut ws: WebSocket) {
    let user_id = NEXT_USER_ID.fetch_add(1, Ordering::Relaxed);
    let (tx, mut rx) = mpsc::unbounded_channel();
    tokio::spawn(async move {
        while let Some(Ok(msg)) = rx.recv().await {
            broadcast_message(&msg).await;
        }
    });
}

六、选型建议

七、总结

框架的选择本质上是权衡开发效率与运行性能的过程。Salvo 通过极简的语法设计和高效的架构，将开发者从重复的配置工作中解放出来，使其能更专注于业务逻辑的实现。对于大多数常规 Web 服务而言，Salvo 提供了一个兼顾性能与开发体验的现代化解决方案。