You need to enable JavaScript to run this app. 使用Ajax将后端返回的字节数组通过Blob实现下载时格式不支持如何修复
优惠活动
大模型
产品
解决方案
定价
更多

使用Ajax将后端返回的字节数组通过Blob实现下载时格式不支持如何修复

故障场景说明

当前尝试通过Ajax方式实现异步文件下载功能,实际下载完成的文件打开时,图片查看器提示不支持该文件格式。原有实现逻辑(后端直接返回byte数组、前端通过表单提交触发下载)可正常运行,目前需要基于Blob方式重构下载流程,排查文件格式损坏问题。

现有实现代码

前端JavaScript实现

function downloadFile(file_no){
    const xhr = new XMLHttpRequest();
    xhr.open("POST","/timewizard/file/download/"+file_no);
    xhr.send();
    xhr.onreadystatechange = () => {
        if (xhr.readyState == 4 && xhr.status == 200){
            if (xhr.responseText != null && xhr.responseText  != "" && xhr.responseText != '[]'){
                let item = JSON.parse(xhr.responseText);
                console.log(item);
                let bytes = new Uint8Array(item.bytes.length);
                let length = bytes.length;
                for (let i = 0; i < length; i++){
                    bytes[i] = item.bytes.charCodeAt(i);
                }
                // let blob = new Blob([item.bytes], {type: item.mime});
                let blob = new Blob(bytes, {type: item.mime});
                console.log(blob);
                let link = document.createElement("a");
                link.href = window.URL.createObjectURL(blob);
                let fileName = "timewizard_" + new Date().getTime();
                link.download = fileName + "." + item.extension;
                link.click();
                // return xhr.responseText;
            }
        }
    }
}

后端Java实现

@RequestMapping(value="/download/{file_no}")
//  public byte[] fileDownload(HttpServletRequest request, HttpServletResponse response, @PathVariable int file_no) {
public Map<String, Object> fileDownload(HttpServletRequest request, HttpServletResponse response, @PathVariable int file_no) {
    Map<String, Object> answer = new HashMap<String, Object>();
    
    FileUploadDto dto = fileUploadBiz.selectOne(file_no);
    String extension = FilenameUtils.getExtension(dto.getFile_name());
    String mime_front = (dto.getFile_type().equals("P"))?"image":"video";
    String mime_back = (extension.toLowerCase().equals("jpg"))?"jpeg":extension.toLowerCase();
    answer.put("mime", mime_front + "/" + mime_back);
    answer.put("extension", extension);
    
    byte[] down = null;
    
    try {
        String uploadPath = WebUtils.getRealPath(request.getSession().getServletContext(), "/resources/image");
        File file = new File(uploadPath + "/" + dto.getFile_name());
        
        down = FileCopyUtils.copyToByteArray(file);
        String filename = new String(file.getName().getBytes(), "8859_1");
        
//          response.setHeader("Content-Disposition", "attachment; filename=\""+filename +"\"");
        
    } catch (FileNotFoundException e) {
        e.printStackTrace();
    } catch (UnsupportedEncodingException e) {
        e.printStackTrace();
    } catch (IOException e) {
        e.printStackTrace();
    }
    answer.put("bytes", down);

//      return down;
    return answer;
    
}
文件格式损坏核心原因
  • 二进制流被JSON序列化破坏:后端将文件byte数组放入Map返回时,框架会将内容转为JSON格式,此时byte数组会被序列化为有符号十进制数值列表,前端拿到的不是原始二进制字节
  • 前端解码方式错误:使用xhr.responseText接收二进制内容时,会强制按UTF-8文本编码解码字节流,遇到ASCII范围外的字节时会发生替换、截断,直接导致文件内容损坏
  • 逐字节转换逻辑存在先天缺陷:循环通过item.bytes.charCodeAt(i)逐字符提取值的逻辑,在处理非ASCII范围的字节时,会因UTF-8变长编码规则拿到错误的字节值,最终生成的字节数组和原始文件内容完全不一致
  • Blob构造参数不合法:代码中new Blob(bytes, ...)的入参没有用数组包裹Uint8Array对象,不符合Blob构造函数的参数要求,无法正确生成可识别的字节块
重构实现思路

后端调整

  • 移除将文件字节流包装为JSON Map的逻辑,改回直接返回byte数组的响应模式
  • 通过HttpServletResponse设置响应头信息:
    • Content-Type 设置为匹配文件的MIME类型
    • Content-Disposition 设置为attachment; filename=原始文件名,传递下载文件名信息
    • Content-Length 设置为文件实际字节长度,避免浏览器截断内容
  • 确保框架不会对byte数组响应做额外JSON序列化处理

前端调整

  • 初始化XHR时显式设置响应类型:xhr.responseType = 'blob',让浏览器自动把二进制流解码为Blob对象,不需要手动解析
  • 响应成功回调中直接使用xhr.response作为Blob源,不再手动从JSON中解析bytes再拼接Uint8Array
  • 从响应头中动态解析原始文件名,生成临时下载链接触发点击即可

内容的提问来源于stack exchange,提问作者lilo

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.17 23:06:01