You need to enable JavaScript to run this app. Angular 9 下载Laravel后端生成的含日文CSV时日文显示异常
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.02 20:27:05