使用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
相关产品推荐
相关产品推荐

