如何用Rust reqwest实现curl --data-binary发送tar包至Docker Build API

我需要把包含Docker镜像的tar归档文件发送到Docker Build API，已经写了基于Rust reqwest的示例代码。用curl的--data-binary参数发送这个tar包时能成功构建镜像，现在想知道怎么在reqwest里复现这个行为。示例代码如下：

// build image
pub fn build_image_fn(docker_api_ip: &str, image_name: &str, img_file_path: &str) -> Result<String, Error> {
  let client = Client::new();
  // read the tar
  let file = File::open(img_file_path).unwrap();
  println!("path: {img_file_path}");
  // post
  let url = format!("http://{docker_api_ip}/build?t={image_name}");
  let response = client
    .post(url)
    .header("Content-Type", "application/tar")
    .body(file)
    .send();
  // Check if the request was successful
  match response {
    Ok(response) => {
      if response.status().is_success() {
        Ok("Image builded successfully".to_string())
      } else {
          let status = response.status().clone();
          let body = response.text().unwrap();
          let err = serde_json::from_str::<ApiErr>(&body).expect("failed to deserialize build_image_fn error json");
          let err_str = format!("Error: code:{}, message: {}", status, err.message);
          Ok(err_str)
      }
    }
    Err(err) => {
      Err(err)
    }
  }
}

问题分析与修复 #

curl的--data-binary @file会原样读取文件原始字节作为请求体发送，不做任何编码或转换，你当前的代码方向是对的，但有几个关键细节需要调整：

1. Content-Type头错误：Docker Build API期望的是application/x-tar而非application/tar，这是最常见的失败原因
2. 文件读取的鲁棒性：原代码用unwrap()会导致程序panic，应该用标准错误处理
3. 显式二进制模式：虽然Linux/macOS下默认是二进制读取，但显式处理能避免Windows下的换行符转换问题

修改后的代码 #

use reqwest::Client;
use std::error::Error;
use std::fs::File;
use std::path::Path;

// 假设你已定义该错误结构体
#[derive(serde::Deserialize)]
struct ApiErr {
    message: String,
}

pub fn build_image_fn(docker_api_ip: &str, image_name: &str, img_file_path: &str) -> Result<String, Box<dyn Error>> {
    let client = Client::new();
    
    // 以二进制模式打开文件，保证原始字节不被修改
    let file = File::open(Path::new(img_file_path))?;
    println!("path: {img_file_path}");

    let url = format!("http://{docker_api_ip}/build?t={image_name}");
    let response = client
        .post(&url)
        // 修正为Docker要求的正确MIME类型
        .header("Content-Type", "application/x-tar")
        // 直接传入File作为body，reqwest会流式发送原始字节，完全等价于curl --data-binary
        .body(file)
        .send()?;

    if response.status().is_success() {
        Ok("镜像构建成功".to_string())
    } else {
        let status = response.status();
        let body = response.text()?;
        let err = serde_json::from_str::<ApiErr>(&body)?;
        let err_str = format!("错误: 状态码:{}, 消息: {}", status, err.message);
        Ok(err_str)
    }
}

关键修改说明 #

• 用?替代unwrap()/expect()，实现优雅的错误传播，避免程序崩溃
• 修正Content-Type为application/x-tar，匹配Docker API的要求
• 保持直接传递File作为请求体：reqwest会自动以流式方式发送文件的原始字节，这和curl --data-binary @file的行为完全一致，没有任何额外编码

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