Rust HTTP请求实践：通过reqwest库实现用户数据获取

洪赫逊

于 2025-06-07 09:02:46 发布

阅读量408

点赞数 4

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00613/article/details/148487678

Rust HTTP请求实践：通过reqwest库实现用户数据获取

roadmap-retos-programacion Ruta de estudio basada en ejercicios de código semanales en 2024 de la comunidad MoureDev para aprender y practicar lógica usando cualquier lenguaje de programación. 项目地址: https://gitcode.com/gh_mirrors/ro/roadmap-retos-programacion

前言

在现代编程语言中，HTTP请求是开发者必备的基础技能之一。Rust作为一门系统级编程语言，通过强大的生态系统提供了出色的HTTP客户端功能。本文将深入探讨如何使用Rust的reqwest库进行HTTP请求，并以实际项目中的代码为例进行详细解析。

准备工作

在开始之前，我们需要在项目中添加必要的依赖项：

[dependencies]
tokio = { version = "1.37.0", features = ["full"] }
serde = { version = "1.0.197", features = ["derive"] }
reqwest = { version = "0.12.4", features = ["json"] }

这三个库各司其职：

tokio：Rust的异步运行时，为异步操作提供支持
serde：Rust的序列化框架，用于处理JSON数据
reqwest：功能强大的HTTP客户端库

核心代码解析

1. 定义数据结构

首先，我们需要定义一个结构体来表示从API获取的用户数据：

#[derive(Deserialize, Debug)]
struct User {
    id: u32,
    name: String,
    username: String,
    email: String,
    phone: String,
}

#[derive(Deserialize)]宏使得这个结构体能够自动从JSON数据反序列化，而Debug则允许我们方便地打印调试信息。

2. 异步获取用户数据

接下来是核心的HTTP请求函数：

async fn get_user(user_id: u32) -> Result<Option<User>, reqwest::Error> {
    let url = format!("https://jsonplaceholder.typicode.com/users/{}", user_id);
    let response = reqwest::get(&url).await?;

    if response.status().is_success() {
        let user: User = response.json().await?;
        Ok(Some(user))
    } else {
        println!("Id: {} No encontrado", user_id);
        println!("status_code: {}", response.status());
        Ok(None)
    }
}

这个函数做了以下几件事：

构建请求URL
发送GET请求并等待响应
检查响应状态码
如果成功，将响应体解析为User结构体
如果失败，打印错误信息并返回None

3. 打印用户信息

为了清晰地展示用户数据，我们定义了一个打印函数：

fn print_user(user_data: Option<User>) {
    if let Some(user) = user_data {
        println!(
            "Usuario con id: '{}':\n\
             Nombre: {}\n\
             Usuario: {}\n\
             Email: {}\n\
             Teléfono: {}\n",
            user.id, user.name, user.username, user.email, user.phone
        );
    }
}

4. 主函数

最后是程序的入口点：

#[tokio::main]
async fn main() -> Result<(), reqwest::Error> {
    let u1 = get_user(1).await?;
    print_user(u1);

    let u2 = get_user(2).await?;
    print_user(u2);

    let u3 = get_user(777).await?; // 不存在的用户ID
    print_user(u3);

    Ok(())
}

#[tokio::main]宏将普通的main函数转换为异步运行时入口。我们依次请求三个用户数据（其中一个是故意不存在的ID），并打印结果。

关键知识点

异步编程：Rust使用async/await语法实现异步操作，配合tokio运行时提供高性能的并发处理能力。
错误处理：Rust的Result类型强制开发者显式处理可能的错误，代码中使用了?操作符简化错误传播。
JSON处理：serde库提供了强大的序列化/反序列化功能，可以轻松地将JSON数据转换为Rust结构体。
HTTP状态码检查：response.status().is_success()检查请求是否成功（状态码2xx）。

实际运行结果

当运行这个程序时，你会看到类似以下输出：

Usuario con id: '1':
Nombre: Leanne Graham
Usuario: Bret
Email: Sincere@april.biz
Teléfono: 1-770-736-8031 x56442

Usuario con id: '2':
Nombre: Ervin Howell
Usuario: Antonette
Email: Shanna@melissa.tv
Teléfono: 010-692-6593 x09125

Id: 777 No encontrado
status_code: 404 Not Found