2***@qq.com
2***@qq.com
  • 发布:40 分钟前
  • 更新:37 分钟前
  • 阅读:11

【报Bug】新版本downloadFile下载中文文件名的文件, 实际保存的文件名是编码了的, 但是返回的tempFilePath还是中文, 导致saveFile和openDocument失败

分类:uni-app

产品分类: uniapp/App

PC开发环境操作系统: Windows

PC开发环境操作系统版本号: windows11 25h2

HBuilderX类型: 正式

HBuilderX版本号: 5.34

手机系统: Android

手机系统版本号: Android 12

手机厂商: 华为

手机机型: matepad11

页面类型: vue

vue版本: vue2

打包方式: 云端

项目创建方式: HBuilderX

示例代码:

uni.downloadFile({
url: url,
success: (res) => {
console.log('tempFilePath', res.tempFilePath);
if (res.statusCode === 200) {
uni.saveFile({
tempFilePath: res.tempFilePath,
success: saveRes =>{
console.log('savedFilePath', saveRes.savedFilePath);
},
fail: saveErr =>{
console.log('saveErr', saveErr);
}
})
}
}
});

操作步骤:

url文件名带中文稳定复现

uni.downloadFile({  
    url: url,  
    success: (res) => {  
        console.log('tempFilePath', res.tempFilePath);  
        if (res.statusCode === 200) {  
            uni.saveFile({  
                tempFilePath: res.tempFilePath,  
                success: saveRes =>{  
                    console.log('savedFilePath', saveRes.savedFilePath);  
                },  
                fail: saveErr =>{  
                    console.log('saveErr', saveErr);  
                }  
            })  
        }  
    }  
});

预期结果:

打印savedFilePath

实际结果:

打印了saveErr, code: 14, 路径不存在; tempFilePath返回的是中文文件名, 但是文件管理实际存的是encodeURIComponent编码了的文件名

bug描述:

新版本downloadFile接口下载文件名带中文的文件, 保存在文件管理的文件名是encodeURIComponent编码了的, 但是接口返回的tempFilePath是没编码的原中文名, 导致saveFile, openDocument, previewImage等接口全都失败, 给这些接口传编码后的路径, 就能正常了, 我知道previewImage可以直接传图片原地址这样下载有点画蛇添足, 我只是做测试, 另外两个接口可就是高频了;

从鸿蒙4(安卓12)的matepad11, 到安卓17的oppoFindX10ProMax, 全都一样的, 跟系统机型无关, 非常非常明确的bug, 之前没这个问题, 具体哪个hx版本开始的不知道, 最近才出现的, 我几个月前的旧基座都没问题, 今天新打了基座也复现了;

虽然这个问题代码很好解决, 但是我找了好一会才找到原因, 而且以前都没这个问题, 都是直接传的原tempFilePath, 现在要给所有的都加编码, 不太方便, 那么多旧项目要新打包的话都得处理一下, 太麻烦了...还是辛苦你们兼容一下了

40 分钟前 负责人:无 分享
已邀请:
Ask小助手

Ask小助手 - Ask社区AI助手

欢迎到专业群( uni-app 官方技术交流群 1 ) 咨询,群中有相关专业的管理员和群友。

感谢这份 bug 反馈,整体质量是比较高的,下面从官方评审角度对反馈内容和问题成立性做一个分析。

一、反馈内容完整性评审

已完成的部分:

  • BUG 标题:清晰点出了问题核心(实际落盘文件名被编码、tempFilePath 仍是中文、两者不一致导致下游接口失败),表述准确。
  • BUG 描述:比较详细,说明了影响接口范围(saveFile、openDocument、previewImage)、验证过的临时方案(传编码后路径可正常)、跨设备复现情况(MatePad 11 / OPPO Find X10 Pro Max),以及"旧基座正常、新基座异常"的版本对比线索,这些信息对定位回归问题很有价值。
  • 预期结果:合理。downloadFile 成功返回 tempFilePath 后传给 saveFile 是官方文档的标准用法(downloadFile 文档、saveFile 文档),预期打印 savedFilePath 是符合文档定义的正常链路。
  • 实际结果:描述具体,包含错误码(code: 14,路径不存在)和根因现象(文件管理中实际文件名是编码后的,tempFilePath 返回的是中文原文件名),逻辑自洽,不属于误报。
  • 分类信息:包含 PC 环境(Windows 11 25H2)、HBuilderX 版本(5.34 正式版)、平台(Android)、系统版本、Vue 版本(Vue2)、厂商机型,基本完整。

需要补充的信息:

  1. 具体可复现的下载 url:代码示例中 url 是外部变量,未给出实际值。请提供一个公开可访问、文件名带中文的直链地址(以及下载的文件类型,如 pdf/图片),否则官方人员无法按你的场景稳定复现。
  2. 旧基座的具体版本号:你提到"几个月前的旧基座没问题",如果能提供旧基座对应的 HBuilderX/基座版本号,有助于官方定位问题是从哪个版本引入的。
  3. 建议补充一个可直接运行的最小示例工程或完整页面(含真实的中文文件名下载地址),并确认一下"安卓17"的具体系统版本号写法,便于核对测试环境。
  4. 另外提醒:我无法识别附件内容,如需提供工程文件,请直接以文本形式贴出关键代码和 url。

二、bug 是否成立的分析

从现有信息判断,这个反馈大概率成立,理由如下:

  1. 现象逻辑自洽:实际落盘文件名(encodeURIComponent 编码后)与接口返回的 tempFilePath(中文原名)不一致,saveFile 按 tempFilePath 找文件自然会报"路径不存在"(code: 14);且你验证了传编码后的路径即可成功,反向证实了"文件名与返回路径不一致"这一根因,不是误报。
  2. 中文文件名一直是 downloadFile 文件名处理上的敏感区域,历史上有过类似问题记录:
    • iOS 端曾出现下载中文文件名文件后 saveFile 报"文件没有发现"的问题(ask 122212);
    • iOS 端 tempFilePath 出现中文乱码导致 saveFile/openDocument 失败,当时官方处理建议是对 url 中的中文和特殊字符做 encodeURIComponent 编码(ask 126289);
    • 早期还出现过自动命名文件名过长导致下载失败的问题,后续版本已修复(ask 103336)。
  3. 5+(plus)层面对下载 url 的官方要求也明确写了"如果 url 地址中包含中文或空格等,需要进行 urlencode 转换"(plus.downloader 文档),说明中文场景在底层文件命名处理上确实存在历史背景。
  4. 你描述的"新版本落盘文件名做了编码、但返回的 tempFilePath 未同步"属于典型的内部处理变更后返回值不一致的回归表现。不过目前知识库中未检索到 HBuilderX 5.34 版本关于 downloadFile 中文文件名处理的官方变更说明或已知问题记录,因此该问题需要官方在对应版本上实际复现确认,现有资料无法确认官方是否已知晓此变更。

三、临时方案与建议

  1. 在官方修复前,你已验证的临时方案(将 tempFilePath 做 encodeURIComponent 后再传给 saveFile/openDocument)可作为过渡处理;旧项目重新打包时可先统一封装一层处理,降低改动成本。
  2. 建议按上述"需补充信息"完善后,将此反馈提交到 ask.dcloud.net.cn 的 bug 反馈板块跟踪处理,附上可复现的中文文件名下载直链和旧/新基座版本号,会更有利于官方快速定位和修复。
  3. 也建议同时用官方 Hello uni-app 示例中的 downloadFile 示例(换成中文文件名的下载地址)在新旧基座上各跑一遍做对照验证,把两边的 tempFilePath 实际值一并贴出,作为版本回归的直接证据。
内容为 AI 生成,仅供参考

要回复问题请先登录或注册