使用 fetch 发起请求时,必须将 responsetype 设置为 arraybuffer 或 blob,随后通过 filereader 读取二进制数据并转换为 base64 字符串,最后利用 xlsx.read 解析该字符串以获取工作表数据。

如何配置 Fetch 请求以正确接收二进制流
在调用 fetch 时,默认返回的是文本格式,直接处理 XLS 文件会导致乱码。正确的做法是在初始化请求对象时指定 responseType: 'arraybuffer',这样浏览器会将响应体作为原始字节数组返回,确保二进制数据的完整性。

const url = '/api/export/data.xls';
fetch(url, {
method: 'GET',
headers: {
'Accept': 'application/vnd.ms-excel'
},
responseType: 'arraybuffer' // 关键:指定响应类型为 arraybuffer
})
.then(response => {
if (!response.ok) {
throw new Error('Network response was not ok');
}
return response.arrayBuffer();
})
.then(buffer => {
// 将 ArrayBuffer 转换为 Base64 字符串以便后续处理
let binary = '';
const bytes = new Uint8Array(buffer);
const length = bytes.byteLength;
for (let i = 0; i {
console.error('Fetch error:', error);
});
上述代码展示了从发起请求到获取 Base64 字符串的完整流程。重点在于 response.arrayBuffer() 方法的调用,它确保了数据不被提前解码。得到的 base64 变量可以直接传递给 Excel 解析库。如果接口返回的是 Blob 类型,也可以直接使用 FileReader 的 readAsDataURL 方法,但 arraybuffer 方式在处理大型文件时内存效率更高。
如何将二进制数据解析为结构化表格对象
拿到 Base64 字符串后,需要借助如 SheetJS (xlsx) 这样的库来解析内容。XLSX.read 函数支持直接传入 Base64 字符串,并指定 type: 'base64',从而生成包含所有工作表信息的 Workbook 对象。解析后的对象结构清晰,可以通过 workbook.SheetNames 获取表名列表,再通过索引访问具体的单元格数据。
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。

// 假设 base64Data 是上一步获取的 Base64 字符串
import * as XLSX from 'xlsx';
function parseXlsFromBase64(base64Data) {
try {
// 使用 XLSX.read 解析 Base64 数据
const workbook = XLSX.read(base64Data, { type: 'base64' });
// 获取第一个工作表的名称
const firstSheetName = workbook.SheetNames[0];
// 获取第一个工作表的数据对象
const worksheet = workbook.Sheets[firstSheetName];
// 将工作表转换为 JSON 数组,header: 1 表示返回二维数组
const jsonData = XLSX.utils.sheet_to_json(worksheet, { header: 1 });
return {
sheetName: firstSheetName,
data: jsonData,
rawWorkbook: workbook
};
} catch (error) {
console.error('Parse error:', error);
return null;
}
}
// 使用示例
parseXlsFromBase64(base64Data).then(result => {
if (result) {
console.log('Sheet Name:', result.sheetName);
console.log('Table Data:', result.data);
}
});
这段代码演示了如何利用 XLSX.read 和 sheet_to_json 将二进制数据转化为 JavaScript 可用的数组结构。header: 1 选项使得每一行数据成为一个数组,保留了原始的行列对应关系。如果需要键值对形式,可以省略该参数或使用 header: 'A' 等选项。解析过程完全在客户端完成,无需后端额外处理,适合大多数前端场景。
当 XLS 文件包含特殊字符或加密时如何处理
如果解析过程中出现错误,通常是因为文件编码问题或文件已加密。对于包含特殊字符的文件,确保 Base64 转换过程中没有引入额外的换行符或空格,因为 XLSX.read 对格式要求严格。若文件被密码保护,XLSX.read 需要提供 password 参数才能解密,否则将抛出异常。此外,对于超大文件,建议结合 Web Worker 进行解析以避免阻塞主线程。
// 处理加密文件的示例
function parseEncryptedXls(base64Data, password) {
try {
const workbook = XLSX.read(base64Data, {
type: 'base64',
password: password // 提供解密密码
});
const worksheet = workbook.Sheets[workbook.SheetNames[0]];
return XLSX.utils.sheet_to_json(worksheet);
} catch (error) {
if (error.message.includes('password')) {
console.error('Incorrect password or encrypted file');
} else {
console.error('Other parse error:', error);
}
return null;
}
}
在实际开发中,应始终包裹 try-catch 块以捕获解析异常。对于非加密但格式损坏的文件,可能需要后端重新生成或提供备用数据源。通过明确区分正常解析与异常处理,可以提高应用的健壮性。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!










