Angular 9 下载Laravel后端生成的含日文CSV时日文显示异常
解决前端下载Laravel后端生成日文CSV时的乱码问题
乱码根因排查
当前两个方案出现日文乱码,本质是两个环节的编码不匹配,和前端生成下载链接的逻辑没有直接关系:
- Angular的
HttpClient在设置responseType: 'text'时,默认硬编码使用ISO-8859-1编码解析响应体,不会自动读取后端响应头声明的编码,在解码环节就已经把日文内容解析成乱码字符串,后续无论加BOM、拼Blob都无法修复已经损坏的文本内容。 - 日本本地化业务系统导出的CSV,为了兼容日文版旧版Excel,通常默认使用Shift_JIS编码,而非通用的UTF-8编码,前端如果没有按对应编码解码,拿到的内容必然出现日文乱码。
修复操作步骤
- 第一步:调整API请求逻辑,绕开Angular内置的错误文本解码
把原本请求文本的逻辑改成请求二进制Blob对象,从根源上避免Angular提前按错误编码解码内容,修正后的apiService.ts代码如下:public getCSV(url: string, params?): Promise<Blob> { const headers = new HttpHeaders({ Accept: 'text/csv', }); // *关键修改:responseType设为blob,不在HTTP层做文本解码* return this.http.get(url, {params, headers, responseType: 'blob'}) .toPromise() .catch(this.handleError()); } - 第二步:在组件层按实际编码解码Blob内容,生成带BOM的最终CSV
拿到Blob原始二进制后,先确认后端CSV的实际编码(Shift_JIS/UTF-8),手动解码成文本后,再加上UTF-8 BOM生成可被Excel正常识别的CSV文件,调整后的component.ts下载逻辑如下:downloadTest(): void { this.apiService.getCSV(this.testurl).then(blobRaw => { if (!blobRaw) return; const fileReader = new FileReader(); fileReader.onload = (e) => { const decodedContent = e.target.result as string; // 增加UTF-8 BOM,兼容所有版本Excel识别日文 const bom = new Uint8Array([0xEF, 0xBB, 0xBF]); const finalCSVBlob = new Blob([bom, decodedContent], { type: 'text/csv;charset=utf-8' }); // 触发本地下载 const aTag = document.createElement("a"); aTag.download = "test.csv"; if (window.navigator.msSaveBlob) { // 兼容IE浏览器 window.navigator.msSaveBlob(finalCSVBlob, aTag.download); } else { aTag.href = window.URL.createObjectURL(finalCSVBlob); document.body.appendChild(aTag); aTag.click(); document.body.removeChild(aTag); // 释放临时生成的Blob地址 window.URL.revokeObjectURL(aTag.href); } }; // 编码参数必须和后端实际输出的CSV编码保持一致: // 后端是Shift_JIS就填'shift_jis',是UTF-8就填'utf-8' fileReader.readAsText(blobRaw, 'shift_jis'); }); }注意:日本本地化业务系统导出的CSV,为了兼容日文版旧版Excel(2016及更早版本识别不带BOM的UTF-8 CSV会出现乱码),通常默认使用Shift_JIS编码,前端如果没有按对应编码解码,拿到的内容必然出现日文乱码。
- 第三步:如果是自研Laravel后端动态生成CSV,从源头统一编码规则
后端生成CSV时直接强制输出UTF-8带BOM的格式,彻底避免前后端编码不匹配的问题,示例代码片段:// 声明响应头 header('Content-Type: text/csv; charset=utf-8'); header('Content-Disposition: attachment; filename=test.csv'); // 输出UTF-8 BOM标记 echo "\xEF\xBB\xBF"; // 后续输出CSV内容时,保证所有字符串均为UTF-8编码即可
原两个方案失效的具体原因
- 数据URI方案:HTTP请求环节已经按错误编码把日文解码成乱码字符串,后续拼接BOM、用
encodeURIComponent编码的都是已经损坏的乱码内容,自然无法正常显示日文。 - Blob临时链接方案:虽然生成Blob的流程正确,但HTTP请求阶段还是用了
responseType: 'text',解码环节的错误没有修复,Blob内部存储的本身就是乱码文本,最终下载的文件自然无法正常展示日文。
内容的提问来源于stack exchange,提问作者MattyO
相关产品推荐
相关产品推荐

