电脑下载正常，手机却乱码？ResponseEntity文件下载问题的解决方案
许多开发者在开发文件下载功能时，会遇到一个棘手的问题：电脑端下载的文件可以正常打开，但手机端却无法打开或显示乱码。本文将分析一个基于ResponseEntity的文件下载案例，并提供相应的解决方案。
案例分析：
后端使用ResponseEntity返回文件流，并设置Content-Disposition头部信息指定文件名。关键代码如下：
HttpStatus statusCode = HttpStatus.OK;
HttpHeaders headers = new HttpHeaders();
if (download) {
String filename = new String(r.getName().getBytes(), "iso8859-1");
headers.add("Content-Disposition", "attachment;filename=" + filename);
}
Resource resource = resourceLoader.getResource("file:" + path + "/" + id);
InputStream in = resource.getInputStream();
byte[] body = new byte[in.available()];
in.read(body);
ResponseEntity<byte[]> streamResponse = new ResponseEntity<>(body, headers, statusCode);
return streamResponse;
前端使用<a></a>标签触发下载：
function handleDownload(file: any) {
let a = document.createElement('a');
let event = new MouseEvent('click');
a.download = file.name;
a.href = file.url;
a.dispatchEvent(event);
}
问题：手机端下载失败或乱码，电脑端正常。问题并非ResponseEntity本身，而是file.url的内容。
问题根源及解决方案：
handleDownload(file: any)函数中的file.url可能是Blob URL或Data URL。移动端浏览器对Blob URL和Data URL的支持度参差不齐，这正是导致手机端下载失败或乱码的主要原因。
建议如下：
-
检查
file.url: 仔细检查file.url的具体内容，确认其是否为Blob URL或Data URL。 -
后端直接返回字节流: 修改后端代码，直接返回文件的字节流，而不是依赖Blob URL或Data URL。前端代码可以根据返回的字节流创建Blob对象，再生成下载链接。这种方式更兼容不同浏览器和设备。
-
改进文件名编码: 确保文件名编码的正确性。使用UTF-8编码可以更好地兼容各种字符集。 可以尝试修改后端代码中的文件名编码方式：
String filename = new String(r.getName().getBytes("UTF-8"), "ISO-8859-1"); // 或其他合适的编码
headers.add("Content-Disposition", "attachment;filename*=UTF-8''" + URLEncoder.encode(filename, "UTF-8"));
通过以上方法，可以有效解决ResponseEntity文件下载在手机端出现乱码或无法打开的问题，确保文件下载功能在不同平台上的稳定性。
