HarmonyOS 鸿蒙Next中request.agent.create无法识别file协议的uri

为什么我用带file协议的uri路径，还是无法识别，无法执行到输出下载任务id那行代码。我不加saveas字段的配置，就能下载执行。

PS：

downLoadRootPath是创建文件后返回的路径。这个路径肯定是没错的。但是为什么就是不行呢。是哪里出错了呢？

更多关于HarmonyOS 鸿蒙Next中request.agent.create无法识别file协议的uri的实战教程也可以访问 https://www.itying.com/category-93-b0.html

h691938207 1楼

【解决方案】

这边当前手机系统是6.0吗？项目是否有升级到api20的版本？从API20开始才持下载网络资源文件至用户文件。

从API20开始request.agent.create支持下载网络资源文件至用户文件，具体实现参考下载网络资源文件至用户文件，需要升级到API20使用。
从API20开始，下载到用户文件场景request.agent.Config的mode属性必须为request.agent.Mode.FOREGROUND，具体参考Config配置。

更多关于HarmonyOS 鸿蒙Next中request.agent.create无法识别file协议的uri的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html

sinazl 2楼

根据文档。可以使用带file协议头的文件路径。并且是调用方创建的。我使用的uri就是我在下载前创建的文件。

sinazl 3楼

在HarmonyOS Next中，request.agent.create无法识别file://协议的URI是因为系统安全策略限制直接访问本地文件路径。鸿蒙应用沙箱机制禁止通过文件协议直接操作应用外部存储路径，需使用鸿蒙特定的资源访问方式。应通过@ohos.file.fs模块的API获取文件URI，或使用DataAbilityHelper访问沙箱内文件资源。系统仅支持特定安全协议（如dataability://）进行跨应用文件交互。

songsunli 4楼

在HarmonyOS Next中，request.agent.create 不支持直接使用 file:// 协议的URI进行下载操作。这是因为系统安全策略限制了从本地文件路径发起下载任务，以避免潜在的安全风险。

从你提供的截图和描述来看，当使用 saveAs 字段时，系统期望的是一个有效的网络资源URI（如 http:// 或 https://），而不是本地文件路径。你提到不加 saveAs 字段时可以正常下载，进一步验证了这一点。

解决方案：

如果目标是下载网络资源并保存到指定路径，请确保 url 使用有效的网络地址。
如果意图是操作本地文件，请使用文件管理API（如 fs 模块）进行复制或移动，而非下载任务。

当前代码中的 file:// URI 触发了协议校验失败，导致下载任务无法创建。调整URI为网络资源或改用文件操作API即可解决。