Rocket 0.5.0-rc.2中如何返回带HTTP状态码的JSON结构？

最优方案：基于枚举的类型安全实现 #

你遇到的核心问题是需要统一返回类型，同时支持不同的成功结构体和固定格式的错误响应，枚举类型是最适合的解决方案——既保留类型安全，又能灵活处理不同响应场景，还能完美适配Rocket 0.5的Responder trait要求。

1. 定义基础结构

首先定义固定格式的错误结构体，以及包含成功/错误分支的通用响应枚举：

use rocket::serde::Serialize;

// 固定格式的错误响应结构体
#[derive(Serialize)]
struct ApiError {
    message: String,
}

// 通用响应枚举，支持任意可序列化的成功数据
#[derive(Serialize)]
#[serde(untagged)] // 避免生成额外的包裹字段（如{"Success": {...}}）
enum ApiResponse<T: Serialize> {
    Success(T),
    Error(ApiError),
}

2. 实现Rocket的Responder trait

针对Rocket 0.5的生命周期要求，为ApiResponse实现Responder，自动处理状态码和JSON序列化：

use rocket::response::{Responder, Response};
use rocket::http::Status;
use rocket::request::Request;
use serde_json::Error as JsonError;

impl<'r, T: Serialize> Responder<'r, 'static> for ApiResponse<T> {
    fn respond_to(self, req: &'r Request<'_>) -> rocket::response::Result<'static> {
        let (status, payload) = match self {
            ApiResponse::Success(data) => (Status::Ok, serde_json::to_string(&data)?),
            ApiResponse::Error(err) => (Status::NotFound, serde_json::to_string(&err)?),
            // 可根据需求扩展其他错误状态码，比如400 BadRequest、500 InternalServerError等
        };

        // 基于序列化后的字符串构建响应，设置正确的状态码和Content-Type
        Response::build_from(payload.respond_to(req)?)
            .status(status)
            .header(rocket::http::ContentType::JSON)
            .ok()
    }
}

3. 在路由中使用

现在可以直接在路由函数中返回ApiResponse<T>，灵活处理成功和错误场景：

#[delete("/customers/<id>")]
pub async fn delete_customer(
    db: &State<Database>,
    id: String,
) -> ApiResponse<Customer> {
    match db.delete_customer(&id).await {
        Ok(deleted_customer) => ApiResponse::Success(deleted_customer),
        Err(_) => ApiResponse::Error(ApiError {
            message: "指定客户不存在".to_string(),
        }),
    }
}

关于Value方案的评估 #

你考虑的Value方案确实可以工作，但存在明显短板：

• 丢失类型安全：编译期无法检查结构体到Value的转换是否正确，容易出现字段遗漏或类型错误
• 代码冗余：需要手动调用serde_json::to_value()转换成功结构体，不如枚举方案利用serde自动序列化简洁
• 调试难度高：Value是动态类型，排查序列化问题时不如静态结构体直观

因此，更推荐上面的枚举实现方案，兼顾类型安全、代码简洁和扩展性。

内容的提问来源于stack exchange，提问作者Stefano Cappa