如何更简洁地为reqwest POST请求生成JSON请求体？

你的问题核心是手动拼接JSON字符串易出错且可读性差，利用serde和reqwest的json()方法可以完美解决，以下提供两种可行方案：

方案一：定义强类型结构体（推荐） #

利用serde的Serialize派生特性，定义与请求体结构匹配的结构体，既保证类型安全，又让代码更清晰。

修改后的完整代码 #

use lazy_static::Lazy;
use reqwest::{blocking::Client, header::{ACCEPT, AUTHORIZATION}};
use serde::{Serialize, Deserialize};

static CLIENT: Lazy<Client> = Lazy::new(|| Client::new());
static GENERATED_TOKEN: Lazy<GeneratedToken> =
    Lazy::new(|| get_token().expect("failed to get token"));

// 补全GeneratedToken结构体定义（假设原逻辑已实现反序列化）
#[derive(Serialize, Deserialize)]
struct GeneratedToken {
    dtable_uuid: String,
    access_token: String,
}

fn get_token() -> Result<GeneratedToken, Box<dyn std::error::Error>> {
    // 原获取token逻辑保持不变，此处为示例返回值
    Ok(GeneratedToken {
        dtable_uuid: "test-uuid".to_string(),
        access_token: "test-token".to_string(),
    })
}

// 定义请求体对应的结构体
#[derive(Serialize)]
struct RegisterRequest {
    #[serde(rename = "table_name")]
    table_name: String,
    row: AdminRow,
}

#[derive(Serialize)]
struct AdminRow {
    email: String,
    password: String,
}

fn register(email: &str, pw: &str) -> bool {
    // 构建请求体实例
    let request_body = RegisterRequest {
        table_name: "admin".to_string(),
        row: AdminRow {
            email: email.to_string(),
            password: pw.to_string(),
        },
    };

    let response = CLIENT
        .post(format!("{SEATABLE_BASE_URL}dtable-server/api/v1/dtables/{}/rows/", GENERATED_TOKEN.dtable_uuid))
        .header(AUTHORIZATION, format!("Bearer {}", GENERATED_TOKEN.access_token))
        .header(ACCEPT, "application/json")
        // 使用json()方法自动序列化并设置Content-Type头
        .json(&request_body)
        .send()
        .is_ok();

    println!("Registration successful with email \"{email}\": {response}");
    response
}

// 假设SEATABLE_BASE_URL已定义
const SEATABLE_BASE_URL: &str = "https://example.com/";

fn main() {
    Lazy::force(&CLIENT);
    println!("Has CLIENT");
    Lazy::force(&GENERATED_TOKEN);
    println!("Has TOKEN?: {}", (GENERATED_TOKEN.access_token.len() > 0).to_string());

    register("email", "pw");
}

方案二：使用动态JSON对象（无需定义结构体） #

如果不想额外定义结构体，可以用serde_json::json!宏快速构建动态请求体，适合临时或简单的请求场景：

修改后的register函数 #

use serde_json::json;

fn register(email: &str, pw: &str) -> bool {
    // 用json!宏快速构建动态JSON
    let request_body = json!({
        "table_name": "admin",
        "row": {
            "email": email,
            "password": pw
        }
    });

    let response = CLIENT
        .post(format!("{SEATABLE_BASE_URL}dtable-server/api/v1/dtables/{}/rows/", GENERATED_TOKEN.dtable_uuid))
        .header(AUTHORIZATION, format!("Bearer {}", GENERATED_TOKEN.access_token))
        .header(ACCEPT, "application/json")
        .json(&request_body)
        .send()
        .is_ok();

    println!("Registration successful with email \"{email}\": {response}");
    response
}

关键优化点 #

• 移除了手动字符串拼接，彻底避免转义错误和格式问题
• reqwest::json()方法会自动将结构体/JSON对象序列化为JSON字符串，并设置Content-Type: application/json请求头，无需手动添加
• 强类型结构体方案提供编译期类型检查，减少运行时错误
• 代码可读性和可维护性大幅提升

内容的提问来源于stack exchange，提问作者András Krausz