如何优雅处理reqwest::get.text结果，替代unwrap避免panic？

核心思路 #

借助Rust的?操作符简化错误传播，配合自定义错误类型（推荐用thiserror crate快速实现）统一归类不同场景的错误，最后在顶层逻辑中捕获错误并记录日志，既避免panic，又能保证代码简洁且错误信息清晰。

具体实现步骤 #

1. 添加依赖 #

在Cargo.toml中引入所需依赖：

[dependencies]
reqwest = { version = "0.11", features = ["blocking"] } # 若用异步则替换为异步特性
thiserror = "1.0"
log = "0.4"
env_logger = "0.10" # 可选，用于快速初始化日志系统

2. 定义自定义错误类型 #

用thiserror把reqwest请求错误、IO读取错误等封装成统一的错误枚举，方便后续处理和日志输出：

use thiserror::Error;

#[derive(Error, Debug)]
enum FetchError {
    #[error("API请求发送失败: {0}")]
    RequestFailed(#[from] reqwest::Error),
    #[error("响应内容读取失败: {0}")]
    ContentReadFailed(#[from] std::io::Error),
    #[error("API返回错误状态码: {0}")]
    BadStatusCode(u16), // 可选，专门处理非2xx状态码
}

3. 封装请求逻辑 #

用?操作符自动处理每一步的错误，函数返回Result<String, FetchError>，避免嵌套match的冗余：

use reqwest::blocking::Client;

fn fetch_api_text(url: &str) -> Result<String, FetchError> {
    let response = Client::new().get(url).send()?;
    
    // 可选：检查响应状态码，非成功状态则返回自定义错误
    if !response.status().is_success() {
        return Err(FetchError::BadStatusCode(response.status().as_u16()));
    }
    
    let text_content = response.text()?;
    Ok(text_content)
}

4. 顶层调用与错误日志 #

在主逻辑中调用封装函数，通过match捕获错误并记录日志：

use log::error;

fn main() {
    env_logger::init(); // 初始化日志
    
    match fetch_api_text("https://api.example.com/simple-text") {
        Ok(content) => println("获取到内容: {}", content),
        Err(e) => error("API内容获取失败: {}", e),
    }
}

优势对比 #

• 对比嵌套match：代码简洁度大幅提升，错误传播逻辑由?自动处理，无需手动嵌套多层判断
• 对比if let：完整保留错误上下文和类型，自定义错误能清晰区分不同失败场景，便于排查问题
• 对比map/and_then链式调用：可读性更强，多步错误处理时?比链式调用更直观，维护成本更低

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