使用Rust reqwest发起Multipart POST时文件部分为空问题

问题根源 #

你的代码存在两个核心问题，导致文件部分被服务器识别为空：

1. 手动覆盖Content-Type头
   reqwest的.multipart()方法会自动生成包含boundary标识的multipart/form-data请求头，这个boundary是服务器解析多部分数据的关键。你手动设置header("Content-Type", "multipart/form-data")会覆盖自动生成的头，缺失boundary信息后，服务器无法正确拆分请求体，进而认为文件部分为空。

2. 参数设计冗余
   bytes参数使用&mut Vec<u8>，但代码仅做了to_vec()的复制操作，完全不需要可变引用，改为&[u8]更符合语义。

此外，unwrap()会在请求失败时直接触发panic，生产环境中应该通过返回Result来处理错误。

修正后的代码 #

use reqwest::multipart::{Form, Part};
use reqwest::Client;
use std::error::Error;

pub async fn save_image(
    &self,
    image_type: String,
    image_path: String,
    bytes: &[u8], // 改为不可变切片引用，符合只读使用场景
) -> Result<(), Box<dyn Error>> { // 返回Result，让调用者处理错误
    let url = format!(
        "{}/object/{}/{}",
        self.config.secrets.base_url, image_type, image_path
    );
    let client = Client::new();
    
    // 创建文件part，可选指定MIME类型帮助服务器识别文件类型
    let part = Part::bytes(bytes.to_vec())
        .file_name("file")
        .mime_str("image/jpeg")?; // 根据实际图片类型调整，比如image/png
    
    let form = Form::new().part("file", part);
    
    let response = client
        .post(&url)
        .bearer_auth(&self.config.secrets.api_key)
        .multipart(form) // 自动生成带boundary的Content-Type头
        .send()
        .await?;
    
    // 检查响应状态码，非2xx则返回错误
    response.error_for_status()?;
    
    Ok(())
}

关键修改说明 #

• 移除手动设置的Content-Type头，依赖multipart()方法自动生成包含boundary的正确请求头。
• 调整bytes参数类型，避免不必要的可变借用。
• 用?替换unwrap()，通过返回Result处理错误，避免程序意外崩溃。
• 可选添加.mime_str()指定文件MIME类型，帮助Supabase更准确地处理文件。

验证方式 #

可以在发送请求前打印请求头，确认Content-Type是否包含boundary：

let request = client.post(&url)
    .bearer_auth(&self.config.secrets.api_key)
    .multipart(form);
println!("{:#?}", request.headers());

正常情况下会看到类似Content-Type: multipart/form-data; boundary=------------------------xxxxxx的头信息。

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