使用file-saver下载REST接口返回的zip文件无法打开如何解决？

问题根因 #

你下载的zip文件已经被二进制转码破坏，文件结构不完整才会触发指针移动报错。90%以上的场景是前端axios未指定二进制响应类型，默认将zip二进制数据按文本格式解码导致内容损坏。

修复方案 #

1. 前端修改（优先级最高） #

axios发送下载请求时必须添加responseType: 'blob'配置，禁止默认的文本转码逻辑，示例代码如下：

import { saveAs } from "file-saver";
import axios from "axios";

// 请求时添加responseType配置
axios.get('/你的下载接口地址', {
  params: { /* 你的请求参数 */ },
  responseType: 'blob' // 必须加这行配置
}).then((response: any) => {
  const blob = new Blob([response.data], { type: "application/zip" });
  saveAs(blob, "Report.zip");
});

如果你是封装的request实例，在对应下载接口的请求拦截逻辑里，针对下载接口单独加上responseType: 'blob'即可。

2. 后端校验（如果前端修改后仍报错） #

• 先做本地验证：把后端生成的zipBytes字节数组直接写入本地磁盘存为zip文件，尝试打开如果正常，说明后端生成逻辑无问题，问题还是出在传输或者前端解析环节。
• 检查是否有全局响应拦截器/统一返回体包装：如果你的项目做了全局接口返回值统一封装（比如给所有接口外层套了{code:200, data:xxx, msg:''}的结构），会把zip二进制内容也套进去，直接破坏文件结构，需要给下载接口排除统一返回体包装逻辑。
• 检查JDBC Blob读取逻辑：你代码里的generated.getFile().getBytes(1, (int)generated.getFile().length())符合JDBC Blob的API规范（下标从1开始），如果你的文件大小超过2G要注意int溢出问题，小文件场景无需修改。

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