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);
}
})
}
}
});
- 发布:40 分钟前
- 更新:37 分钟前
- 阅读:11
【报Bug】新版本downloadFile下载中文文件名的文件, 实际保存的文件名是编码了的, 但是返回的tempFilePath还是中文, 导致saveFile和openDocument失败
产品分类: uniapp/App
PC开发环境操作系统: Windows
PC开发环境操作系统版本号: windows11 25h2
HBuilderX类型: 正式
HBuilderX版本号: 5.34
手机系统: Android
手机系统版本号: Android 12
手机厂商: 华为
手机机型: matepad11
页面类型: vue
vue版本: vue2
打包方式: 云端
项目创建方式: HBuilderX
示例代码:
操作步骤:
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);
}
})
}
}
});
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
打印savedFilePath
实际结果:
打印了saveErr, code: 14, 路径不存在; tempFilePath返回的是中文文件名, 但是文件管理实际存的是encodeURIComponent编码了的文件名
打印了saveErr, code: 14, 路径不存在; tempFilePath返回的是中文文件名, 但是文件管理实际存的是encodeURIComponent编码了的文件名
bug描述:
新版本downloadFile接口下载文件名带中文的文件, 保存在文件管理的文件名是encodeURIComponent编码了的, 但是接口返回的tempFilePath是没编码的原中文名, 导致saveFile, openDocument, previewImage等接口全都失败, 给这些接口传编码后的路径, 就能正常了, 我知道previewImage可以直接传图片原地址这样下载有点画蛇添足, 我只是做测试, 另外两个接口可就是高频了;
从鸿蒙4(安卓12)的matepad11, 到安卓17的oppoFindX10ProMax, 全都一样的, 跟系统机型无关, 非常非常明确的bug, 之前没这个问题, 具体哪个hx版本开始的不知道, 最近才出现的, 我几个月前的旧基座都没问题, 今天新打了基座也复现了;
虽然这个问题代码很好解决, 但是我找了好一会才找到原因, 而且以前都没这个问题, 都是直接传的原tempFilePath, 现在要给所有的都加编码, 不太方便, 那么多旧项目要新打包的话都得处理一下, 太麻烦了...还是辛苦你们兼容一下了
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)、厂商机型,基本完整。
需要补充的信息:
- 具体可复现的下载 url:代码示例中
url是外部变量,未给出实际值。请提供一个公开可访问、文件名带中文的直链地址(以及下载的文件类型,如 pdf/图片),否则官方人员无法按你的场景稳定复现。 - 旧基座的具体版本号:你提到"几个月前的旧基座没问题",如果能提供旧基座对应的 HBuilderX/基座版本号,有助于官方定位问题是从哪个版本引入的。
- 建议补充一个可直接运行的最小示例工程或完整页面(含真实的中文文件名下载地址),并确认一下"安卓17"的具体系统版本号写法,便于核对测试环境。
- 另外提醒:我无法识别附件内容,如需提供工程文件,请直接以文本形式贴出关键代码和 url。
二、bug 是否成立的分析
从现有信息判断,这个反馈大概率成立,理由如下:
- 现象逻辑自洽:实际落盘文件名(encodeURIComponent 编码后)与接口返回的 tempFilePath(中文原名)不一致,saveFile 按 tempFilePath 找文件自然会报"路径不存在"(code: 14);且你验证了传编码后的路径即可成功,反向证实了"文件名与返回路径不一致"这一根因,不是误报。
- 中文文件名一直是 downloadFile 文件名处理上的敏感区域,历史上有过类似问题记录:
- iOS 端曾出现下载中文文件名文件后 saveFile 报"文件没有发现"的问题(ask 122212);
- iOS 端 tempFilePath 出现中文乱码导致 saveFile/openDocument 失败,当时官方处理建议是对 url 中的中文和特殊字符做 encodeURIComponent 编码(ask 126289);
- 早期还出现过自动命名文件名过长导致下载失败的问题,后续版本已修复(ask 103336)。
- 5+(plus)层面对下载 url 的官方要求也明确写了"如果 url 地址中包含中文或空格等,需要进行 urlencode 转换"(plus.downloader 文档),说明中文场景在底层文件命名处理上确实存在历史背景。
- 你描述的"新版本落盘文件名做了编码、但返回的 tempFilePath 未同步"属于典型的内部处理变更后返回值不一致的回归表现。不过目前知识库中未检索到 HBuilderX 5.34 版本关于 downloadFile 中文文件名处理的官方变更说明或已知问题记录,因此该问题需要官方在对应版本上实际复现确认,现有资料无法确认官方是否已知晓此变更。
三、临时方案与建议
- 在官方修复前,你已验证的临时方案(将 tempFilePath 做 encodeURIComponent 后再传给 saveFile/openDocument)可作为过渡处理;旧项目重新打包时可先统一封装一层处理,降低改动成本。
- 建议按上述"需补充信息"完善后,将此反馈提交到 ask.dcloud.net.cn 的 bug 反馈板块跟踪处理,附上可复现的中文文件名下载直链和旧/新基座版本号,会更有利于官方快速定位和修复。
- 也建议同时用官方 Hello uni-app 示例中的 downloadFile 示例(换成中文文件名的下载地址)在新旧基座上各跑一遍做对照验证,把两边的 tempFilePath 实际值一并贴出,作为版本回归的直接证据。