HarmonyOS 鸿蒙Next中webview.WebDownloadItem的getSuggestedFileName方法获取的数据乱码

HarmonyOS 鸿蒙Next中webview.WebDownloadItem的getSuggestedFileName方法获取的数据乱码 使用webview.WebDownloadItem的getSuggestedFileName方法获取的中文数据是乱码的，

cke_692.png

cke_994.png

我有尝试去使用utf8进行编解码操作来让他展示中文字符串。但是一直没有成功。

cke_11163.png

cke_11742.png

那么是我用的方法有问题，还是这种乱码的数据本身就无法再转码回中文了？


更多关于HarmonyOS 鸿蒙Next中webview.WebDownloadItem的getSuggestedFileName方法获取的数据乱码的实战教程也可以访问 https://www.itying.com/category-93-b0.html

11 回复 
downloadDelegate.onBeforeDownload((webDownloadItem: webview.WebDownloadItem) => {
  const suggestedName = webDownloadItem.getSuggestedFileName();
  // 尝试修复乱码
  const buffer = new Uint8Array(suggestedName.length);
  for (let i = 0; i < suggestedName.length; i++) {
    buffer[i] = suggestedName.charCodeAt(i);
  }
  const decoder = new TextDecoder('gbk'); // 根据实际编码调整
  const correctedName = decoder.decode(buffer);
  
  const dir = getContext().cacheDir + "/web/" + correctedName;
  webDownloadItem.start(dir);
});

试试这个吧，gbk不行就换成个utf

另外找你们后端确认下，http的请求有没有正确设置编码，

Content-Disposition: attachment; filename*=UTF-8’’%E6%96%87%E4%BB%B6%E5%90%8D.txt

更多关于HarmonyOS 鸿蒙Next中webview.WebDownloadItem的getSuggestedFileName方法获取的数据乱码的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


【问题分析】

中文显示为编码。形如%E5%8D%97%E4%BA%AC%E5%B8%82。

【背景知识】

  • HarmonyOS中解编码的API是TextEncoder和TextDecoder。
    • TextEncoder用于将字符串编码为字节数组，支持多种编码格式。
    • TextDecoder用于将字节数组解码为字符串，可以处理多种编码格式。
    • 编解码的类型包括UTF-8、UTF-16LE/BE、ISO-8859和Windows-1251等不同的编码格式。
    • 无论是对请求的数据还是文本Text的字符串做编解码，都可以使用TextEncoder和TextDecoder来解决乱码问题。

【解决方案】

将网络数据转换UTF-8格式

import { util } from '@kit.ArkTS'; 
import axios, { AxiosResponse } from '@ohos/axios'; 

@Entry 
@Component 
struct FriendsBook {
  // ...
  aboutToAppear() { 
    axios<string, AxiosResponse<string>, null>({ 
      method: 'get', 
      url: 'xxx', // 网络请求地址 
      // 在使用util.TextDecoder方法时，编码和解码格式要一致，所以在获取时需将数据类型设置为ARRAY_BUFFER，否则会出现乱码。
      responseType: 'ARRAY_BUFFER' 
    }) 
      .then((res: AxiosResponse) => { 
        // 首先使用create构造TextDecoder实例，将编码格式设置为gbk。
        const textDecoder = util.TextDecoder.create('gbk', { ignoreBOM: true }); 
        // 其次使用decodeWithStream方法通过解码输入的参数，输出对应UTF-8格式的文本字符串。其中传入的参数必须为Uint8Array格式，因此需将获取的数据使用Uint8Array方法转换数组类型。
        const result = new Uint8Array(res.data); 
        const resultString = textDecoder.decodeToString(result, { stream: false }); 
        // 解析json字符串。
        const jsonResult = JSON.parse(resultString) as string; 
      }) 
  } 
}

【参考文档】

应用里的文本内容显示乱码-行业常见问题-教育类行业实践-场景化知识 - 华为HarmonyOS开发者

使用 webview.WebDownloadItem 的 getSuggestedFileName 方法获取中文文件名乱码的问题，通常是由于编码处理方式或数据源未正确适配导致的。

文件名可能经过 URL 编码（如 %E4%B8%AD%E6%96%87.txt），需要先进行解码再转 UTF-8。

找HarmonyOS工作还需要会Flutter的哦，有需要Flutter教程的可以学学大地老师的教程，很不错，B站免费学的哦：https://www.bilibili.com/video/BV1S4411E7LY/?p=17

你可以尝试打印一下webDownloadItem.getUrl() 是什么内容。或者本事这个URL就是乱码，所以getSuggestedFileName()得到的也是乱码。

有要学HarmonyOS AI的同学吗，联系我：https://www.itying.com/goods-1206.html

使用getUrl()拿到的URL中，中文部分是编码后的，例如就是 http://192.168.61.154/%E5%BC%80%E6%9C%BA%E5%8A%A8%E7%94%BB.mp4。

没错，你把这个反编码之后就是中文了，

这种是url转码，试试 decodeURIComponent，

在HarmonyOS Next中，WebDownloadItem的getSuggestedFileName方法返回乱码通常与编码格式不匹配有关。鸿蒙使用UTF-8作为默认编码，若下载文件名包含非ASCII字符或服务器未正确设置Content-Disposition响应头编码，可能导致解码异常。建议检查网络请求响应头的字符集声明，确认服务端传输文件名时采用UTF-8编码。可通过手动设置解码格式或使用decodeURIComponent等方法处理返回数据。

从你提供的截图来看，getSuggestedFileName() 返回的中文文件名确实出现了编码问题。这通常是因为文件名在 HTTP 响应头 Content-Disposition 中未正确编码，或者 WebView 在解析时未正确处理编码导致的。

乱码数据能否还原取决于其损坏程度。如果只是简单的编码错位（如 UTF-8 被误读为 Latin-1），通过逆向转码仍有可能恢复。但若数据已严重损坏，则可能无法完全还原。

建议尝试以下方法：

  1. 检查服务器响应头：确认 Content-Disposition 头中的文件名是否已正确编码为 UTF-8，例如：

    Content-Disposition: attachment; filename*=UTF-8''%E6%96%87%E4%BB%B6.txt

  2. 手动解码尝试：对返回的乱码字符串按常见编码（如 ISO-8859-1）解码后，再尝试用 UTF-8 重新编码：

    const decoded = new TextDecoder('iso-8859-1').decode(data);
const fixed = new TextDecoder('utf-8').decode(new TextEncoder().encode(decoded));

  3. 使用备用方案：若无法修复，可考虑通过 URL 路径解析或自定义下载逻辑生成文件名。

当前现象更可能是服务器端未规范编码所致，建议优先检查源头编码设置。

回到顶部