如何在Rocket框架中为content::JSON类型响应添加自定义响应头

解决方案 #

Rocket v0.5的Responder机制支持多种灵活的返回值形式来添加自定义响应头，你可以选择以下任意一种方式实现：

方案1：使用元组组合响应头和响应体（最简方案） #

Rocket 原生支持将Header、多个Header和任意Responder组合成元组作为返回值，框架会自动合并所有响应头和响应内容，无需手动构造完整Response。
首先导入所需依赖：

use rocket::http::Header;
use rocket::serde::json::content;

修改后的路由代码如下：

#[get("/route")]
pub async fn my_route() -> (Header<'static>, content::Json<String>) {
    let json = rocket::serde::json::serde_json::to_string(&my_data).unwrap();
    // 第一个元素是自定义响应头，第二个是原有Json响应内容
    (
        Header::new("Cache-Control", "max-age=120"),
        content::Json(json)
    )
}

如果需要添加多个自定义响应头，直接在元组中增加Header元素即可：

#[get("/route")]
pub async fn my_route() -> (Header<'static>, Header<'static>, content::Json<String>) {
    let json = rocket::serde::json::serde_json::to_string(&my_data).unwrap();
    (
        Header::new("Cache-Control", "max-age=120"),
        Header::new("X-Custom-Header", "custom-value"),
        content::Json(json)
    )
}

方案2：手动构造Response #

如果你需要更灵活的响应控制，直接构造Response时遇到生命周期问题，是因为你传入了临时引用作为响应体，直接传入所有权属于当前函数的String即可解决，无需担心生命周期：
导入依赖：

use rocket::http::{ContentType, Header};
use rocket::response::Response;

代码示例：

#[get("/route")]
pub async fn my_route() -> Response<'static> {
    let json = rocket::serde::json::serde_json::to_string(&my_data).unwrap();
    Response::build()
        .header(ContentType::JSON)
        .header(Header::new("Cache-Control", "max-age=120"))
        .sized_body(json.len(), std::io::Cursor::new(json))
        .finalize()
}

这里json是String类型，所有权被转移到Response中，不存在生命周期冲突问题。

你之前写法不生效的原因 #

content::Json类型本身没有提供set_raw_header方法，该方法是Response结构体的方法，直接对content::Json实例调用自然不会生效。

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