二、前置條件

1. 熟悉 Rust 并安裝 cargo
2. 了解 HTTP 請求與 REST 概念
3. 已安裝 SQLite（或 PostgreSQL）

?? AI 助攻
想自動生成帶注釋的 Cargo.toml？用「代碼生成」提示詞，30 秒即可拿到模板，再交給「代碼優化」砍掉冗余特性，編譯速度提升 20%！

三、項目初始化與依賴配置

cargo new rust-rocket-diesel && cd $_
cargo add diesel --features sqlite
cargo add rocket rocket_contrib rocket_codegen
cargo add serde serde_json serde_derive
cargo add dotenv

Cargo.toml 關鍵片段：

[dependencies]
diesel = { version = "1.4.5", features = ["sqlite"] }
rocket = "0.4.11"
rocket_contrib = "0.4.11"
serde = { version = "1.0", features = ["derive"] }
serde_json = "1.0"
dotenv = "0.15.0"

四、Diesel 數據庫設置

1. 安裝 CLI 并初始化

cargo install diesel_cli --no-default-features --features sqlite
echo "DATABASE_URL=database.db" > .env
diesel setup

2. 創建遷移

diesel migration generate create_students

migrations/xxxx_create_students/up.sql:

CREATE TABLE students (
  id INTEGER PRIMARY KEY AUTOINCREMENT,
  name TEXT NOT NULL,
  age INTEGER NOT NULL
);

down.sql:

DROP TABLE students;

3. 應用遷移

diesel migration run
# 自動生成 src/schema.rs

五、定義模型與路由

1. 模型與 JSON 映射

use serde::{Deserialize, Serialize};
use diesel::prelude::*;

#[derive(Serialize, Deserialize, Queryable, Insertable, AsChangeset)]
#[table_name = "students"]
pub struct Student {
    pub id: Option<i32>,
    pub name: String,
    pub age: i32,
}

2. Rocket 數據庫連接池

use rocket_contrib::databases::diesel::SqliteConnection;
use rocket::http::Status;
use rocket::response::status;
use rocket::Json;

#[database("sqlite_db")]
pub struct DbConn(SqliteConnection);

六、CRUD 端點實現

1. POST /student —— 創建學生

#[post("/student", format = "json", data = "<new_student>")]
fn create_student(
    new_student: Json<Student>,
    conn: DbConn,
) -> Result<Json<Value>, Status> {
    conn.run(|c| {
        diesel::insert_into(students::table)
            .values(&new_student.into_inner())
            .execute(c)
            .map_err(|_| Status::InternalServerError)?;
        Ok(json!({ "status": "success" }))
    })
}

2. GET /students —— 查詢全部

#[get("/students")]
fn get_students(conn: DbConn) -> Result<Json<Value>, Status> {
    conn.run(|c| {
        let results = students::table
            .load::<Student>(c)
            .map_err(|_| Status::InternalServerError)?;
        Ok(Json(json!(results)))
    })
}

3. PUT /students/ —— 更新

#[put("/students/<id>", format = "json", data = "<update>")]
fn update_student(
    id: i32,
    update: Json<Student>,
    conn: DbConn,
) -> Result<Json<Value>, Status> {
    conn.run(|c| {
        diesel::update(students::table.find(id)))
            .set(&update.into_inner())
            .execute(c)
            .map_err(|_| Status::InternalServerError)?;
        Ok(json!({ "status": "success", "updated_id": id }))
    })
}

4. DELETE /students/ —— 刪除

#[delete("/students/<id>")]
fn delete_student(id: i32, conn: DbConn) -> Result<Json<Value>, Status> {
    conn.run(|c| {
        diesel::delete(students::table.find(id)))
            .execute(c)
            .map_err(|_| Status::InternalServerError)?;
        Ok(json!({ "status": "success", "deleted_id": id }))
    })
}

?? AI 審查
把「Diesel 查詢錯誤處理」提交評審？「代碼審查助手」可自動檢查連接池泄露、SQL 注入風險，提前發現 80% 潛在 Bug！

七、啟動與測試

1. 運行服務

cargo run
# 默認監聽 localhost:8000

2. 快速驗證（curl）

# 新增學生
curl -X POST localhost:8000/student \
  -H "Content-Type: application/json" \
  -d '{"name":"Alice","age":20}'

# 查詢全部
curl localhost:8000/students

# 更新
curl -X PUT localhost:8000/students/1 \
  -H "Content-Type: application/json" \
  -d '{"name":"Alice","age":21}'

# 刪除
curl -X DELETE localhost:8000/students/1

? AI 補救
把「curl 測試命令」寫進 README 太麻煩？用「代碼文檔生成器」提示詞，自動在函數頭部生成標準注釋，提醒后續接入 Postman 集合，文檔一鍵達標！

八、進階路線圖

九、總結與下一步

通過本教程，您已學會：

• 使用 Rocket 定義 REST 端點
• 使用 Diesel 進行類型安全的 CRUD
• JSON 自動序列化/反序列化
• 連接池與錯誤處理最佳實踐

下一步可在此基礎上添加認證、分頁、OpenAPI 文檔等功能，打造生產級后端。祝編碼愉快！

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

原文鏈接: https://earthly.dev/blog/rust-api-rocket-diesel/