使用Rust Actix-web下载文件时遭遇Content type error问题求助

问题背景 #

使用Actix-web 4实现Zip文件下载功能时，调用API出现Content type error错误。相关代码及依赖如下：

初始服务端代码 #

pub async fn download_project(
    form: web::Json<DownloadProj>
) -> Result<NamedFile> {
    let trash_result = handle_compress_proj(&form.0);
    return Ok(trash_result.unwrap());
}

压缩处理函数 #

pub fn handle_compress_proj(_req: &DownloadProj) -> Option<NamedFile> {
    let archive_path = gen_zip();
    let file_result = NamedFile::open(archive_path);
    if let Err(err) = file_result {
        error!("read file error,{}", err);
        return None;
    }
    return Some(file_result.unwrap());
}

依赖版本 #

actix-web = "4"
actix-web-validator = "5.0.1"
actix-rt = "2.9.0"
actix-multipart = "0.6.1"
actix-files = "0.6.2"

尝试调整代码后问题仍未解决：

pub async fn download_project(
    req: HttpRequest,
    form: web::Json<DownloadProj>
) -> impl Responder {
    let path = handle_compress_proj(&form.0);
    match NamedFile::open(&path) {
        Ok(fe) => NamedFile::into_response(fe, &req),
        Err(_) => HttpResponse::BadRequest().json("can't download file")
    }
}

解决方案 #

1. 修正请求参数的Content-Type匹配问题 #

web::Json<DownloadProj>要求客户端请求必须携带Content-Type: application/json头，且请求体为JSON格式。如果客户端发送的是表单数据（如application/x-www-form-urlencoded或multipart/form-data），会直接触发Content type error。

• 若客户端使用JSON请求：确保请求头包含Content-Type: application/json，请求体结构与DownloadProj一致。
• 若客户端使用表单提交：将web::Json替换为web::Form，同时客户端调整请求头为对应表单类型。

2. 优化文件响应的错误处理与头信息设置 #

原代码存在unwrap() panic风险，且未明确设置Zip文件的Content-Type，可能导致响应头异常。修正后的代码如下：

修正后的下载接口

use actix_web::{HttpRequest, HttpResponse, web, Responder};
use actix_files::{NamedFile, Disposition};
use std::io;

pub async fn download_project(
    req: HttpRequest,
    form: web::Json<DownloadProj>
) -> impl Responder {
    match handle_compress_proj(&form.0) {
        Ok(mut file) => {
            // 设置Zip文件的MIME类型和下载文件名
            file.set_content_type("application/zip")
                .set_disposition(Disposition::attachment("project.zip"))
                .into_response(&req)
        }
        Err(e) => {
            error!("文件处理失败: {}", e);
            HttpResponse::InternalServerError().json("无法完成文件下载")
        }
    }
}

修正后的压缩处理函数

将返回类型从Option<NamedFile>改为Result<NamedFile, io::Error>，避免unwrap带来的崩溃：

pub fn handle_compress_proj(_req: &DownloadProj) -> io::Result<NamedFile> {
    let archive_path = gen_zip(); // 确保该函数返回有效的文件路径
    NamedFile::open(archive_path)
}

3. 检查gen_zip()函数的正确性 #

确保gen_zip()生成的文件路径有效，且压缩后的Zip文件确实存在且可读取。若该函数生成路径错误或文件未成功创建，会导致后续文件读取失败，间接引发响应异常。

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