Rust REST API 开发全指南：从 RESTful 原则到 Rocket & Actix 实战

一、RESTful 核心原则速览

二、为什么选择 Rust？

• 性能：接近 C 的速度，零成本抽象
• 内存安全：所有权模型编译期消除悬垂指针/泄漏
• 并发 fearless：async/await + Tokio 无需 GC
• 生态：Cargo 一键管理依赖、文档、测试

💡 AI 助攻
想自动生成带注释的 Cargo.toml？用「代码生成」提示词，30 秒即可拿到模板，再交给「代码优化」砍掉冗余特性，编译速度提升 20%！

三、技术栈选型

四、Rocket 最小可运行示例

1. 项目初始化

cargo new rust-rest-rocket && cd $_
cargo add rocket diesel serde serde_json

2. 模型与路由

#[macro_use] extern crate rocket;
use rocket::serde::{Serialize, Deserialize, json::Json};

#[derive(Serialize, Deserialize)]
struct User {
    id: Option<i32>,
    name: String,
}

#[get("/users")]
fn list_users() -> Json<Vec<User>> {
    Json(vec![User { id: Some(1), name: "Alice".into() }])
}

#[post("/users", format = "json", data = "<user>")]
fn create_user(user: Json<User>) -> Json<User> {
    Json(User { id: Some(2), name: user.name.clone() })
}

#[launch]
fn rocket() -> _ {
    rocket::build()
        .mount("/", routes![list_users, create_user])
}

3. 运行与测试

cargo run
# 另开终端
curl http://localhost:8000/users
curl -X POST http://localhost:8000/users -H "Content-Type: application/json" -d '{"name":"Bob"}'

🔍 AI 审查
把「JSON 解析错误处理」提交评审？「代码审查助手」可自动检查空值、类型匹配，提前发现 80% 潜在 Bug！

五、Actix 异步版本（可选）

use actix_web::{get, post, web, App, HttpServer, Responder};
use serde::{Deserialize, Serialize};

#[derive(Serialize, Deserialize)]
struct Task {
    id: u32,
    title: String,
}

#[get("/tasks")]
async fn list_tasks() -> impl Responder {
    web::Json(vec![Task { id: 1, title: "Learn Rust".into() }])
}

#[post("/tasks")]
async fn create_task(task: web::Json<Task>) -> impl Responder {
    web::Json(task.into_inner())
}

#[actix_web::main]
async fn main() -> std::io::Result<()> {
    HttpServer::new(|| App::new().service(list_tasks).service(create_task))
        .bind("127.0.0.1:8080")?
        .run()
        .await
}

六、CRUD 端点一览

✅ AI 补救
把「curl 测试命令」写进 README 太麻烦？用「代码文档生成器」提示词，自动在函数头部生成标准注释，提醒后续接入 Postman 集合，文档一键达标！

七、测试与优化

1. 单元测试：cargo test
2. 集成测试：使用 reqwest 客户端调用本地服务
3. 性能压测：wrk -t12 -c400 -d30s http://localhost:8000/users
4. 内存检测：valgrind --tool=memcheck ./target/release/your_bin

八、进阶路线图

九、总结与下一步

通过本教程，您已掌握：

• RESTful 设计原则与 Rust 实现
• Rocket/Actix 路由与中间件
• Diesel/SQLx 数据库交互
• JSON 自动序列化/反序列化
• 单元测试与性能压测

下一步可添加认证、分页、OpenAPI 文档等功能，打造生产级后端。祝编码愉快！

今晚就 push 到 GitHub，明天就能用 Fly.io 一键部署！🚀

原文链接: https://blog.cubed.run/day-33-rest-api-development-in-rust-4c11d151cf69