用 Rust + Actix-Web 打造“Hello, WebSocket!”——从握手到回声,只需 50 行代码

用 Rust + Actix-Web 打造"Hello, WebSocket!"------从握手到回声,只需 50 行代码

一、为什么选择 Rust 写 WebSocket?

  • 零成本抽象:编译期确定生命周期,无 GC 抖动,延迟低至微秒级
  • actix-web:Tokio 生态最成熟的 Web 框架,单机轻松扛 100k 并发
  • 类型安全:消息格式一旦定义,编译器帮你杜绝"字段对不上"的运行时崩溃

二、核心代码逐行拆解

下面这份 echo 处理器就是全部业务逻辑------没有魔法,只有 Rust 标准流程:

rust 复制代码
pub async fn echo(
    req: HttpRequest,          // HTTP 升级握手请求
    stream: web::Payload,      // 原始 TCP 字节流
) -> Result<HttpResponse, Error> {
    // 1. 协议升级:返回 101 Switching Protocols
    let (res, mut session, stream) = actix_ws::handle(&req, stream)?;

    // 2. 消息聚合:把可能分片的 WebSocket 帧拼成完整消息
    let mut stream = stream
        .aggregate_continuations()
        .max_continuation_size(2_usize.pow(20)); // 1 MiB 上限

    // 3. 异步任务:在后台持续读写,不阻塞主线程
    rt::spawn(async move {
        while let Some(msg) = stream.next().await {
            match msg {
                Ok(AggregatedMessage::Text(text)) => {
                    println!("↑ {}", text);
                    session.text(text).await.unwrap(); // 原样回声
                }
                Ok(AggregatedMessage::Binary(bin)) => {
                    println!("↑ (bin) {:x?}", bin);
                    session.binary(bin).await.unwrap();
                }
                Ok(AggregatedMessage::Ping(p)) => {
                    println!("↑ ping");
                    session.pong(&p).await.unwrap(); // 保活
                }
                _ => {} // Close/Pong 直接忽略
            }
        }
    });

    Ok(res) // 4. 立即返回 101,升级完成
}

三、把 WebSocket 挂到路由表

config_routes 里加一行即可:

rust 复制代码
web::scope("/ws").route("", web::get().to(echo))

前端连接示例:

javascript 复制代码
const ws = new WebSocket('ws://localhost:8080/api/ws');
ws.onmessage = (ev) => console.log('↓', ev.data);
ws.send('Hello Rust!');

四、性能小贴士

  1. 零拷贝session.text(text) 直接借用 String,无需额外克隆
  2. 背压保护max_continuation_size 限制单消息大小,防内存炸弹
  3. 任务隔离rt::spawn 让每条连接独立调度,互不影响

五、下一步?

  • broadcast 频道实现聊天室
  • serde 把 JSON 消息强类型化
  • rustls 升级成 wss 安全连接

完整项目已上传 GitHub,克隆即可跑:

bash 复制代码
git clone https://github.com/your-name/actix-ws-echo
cd actix-ws-echo && cargo run

打开浏览器,WebSocket 握手→回声 ,只需一次 cargo run,你就拥有了毫秒级延迟的实时通信后端。Enjoy Rust!

相关推荐
ObjectX前端实验室13 小时前
从零到一:系统化掌握大模型应用开发【目录】
前端·llm·agent
guoyp212613 小时前
前端实验(二)模板语法
前端·vue.js
葡萄城技术团队13 小时前
Excel 转在线协作难题破解:SpreadJS 纯前端表格控件的技术方案与实践
前端·excel
我的xiaodoujiao13 小时前
Windows系统Web UI自动化测试学习系列3--浏览器驱动下载使用
前端·windows·测试工具·ui
一只小风华~13 小时前
学习笔记:Vue Router 中的嵌套路由详解[特殊字符]概述
前端·javascript·vue.js
泻水置平地13 小时前
若依前后端分离版实现前端国际化步骤
前端
Villiam_AY13 小时前
从后端到react框架
前端·react.js·前端框架
CodeCraft Studio13 小时前
全球知名的Java Web开发平台Vaadin上线慧都网
java·开发语言·前端·vaadin·java开发框架·java全栈开发·java ui 框架
一只小风华~14 小时前
Vue Router 命名路由学习笔记
前端·javascript·vue.js·笔记·学习·ecmascript
我是华为OD~HR~栗栗呀14 小时前
前端面经-高级开发(华为od)
java·前端·后端·python·华为od·华为·面试