悟空浏览器下载失败需五步排查：一、授存储权限并设为“始终允许”；二、清下载管理器缓存与数据；三、改默认路径至/internal storage/Download；四、关广告拦截中的“下载链接保护”；五、提取直链用ADM接管下载。
悟空浏览器下载文件时提示“任务失败”，页面无反应、进度条卡在0%或直接弹出红色错误提示，说明下载请求已被系统或浏览器内核主动中断，必须逐层解除权限、路径、网络和拦截策略的阻断才能恢复。
检查并授予存储写入权限
未开启存储权限时，所有下载操作都会静默失败，不报错也不提示，这是最常被忽略的根源。【必须设为“始终允许”，仅“使用时允许”在后台下载场景下会失效】
1、进入手机「设置」→「应用管理」→ 搜索并点击「悟空浏览器」；
2、点「权限管理」→ 找到「存储」或「文件和媒体」→ 开关设为允许；
3、若选项里有「仅在使用中允许」，长按该条目→ 选择「始终允许」；
4、重启悟空浏览器后，立即尝试下载一个1KB的txt小文件验证权限是否生效。
强制清除系统下载管理器缓存
安卓系统级下载服务（DownloadProvider）一旦缓存损坏，就会拒绝接收任何新任务，浏览器界面显示失败但不给出具体原因。此操作不会删除你已成功下载的文件。
1、进手机「设置」→「应用管理」→ 滑动找到「下载管理器」（名称可能为“Download Manager”）；
2、点「存储」→ 先点「清除缓存」→ 再点「清除数据」；
3、重启手机，等系统服务完全重载后再打开悟空浏览器。
更换默认下载路径至内部存储
很多失败源于路径指向了已卸载的SD卡、加密分区或Android 11+沙盒下的私有目录。/sdcard/Download 是唯一全版本兼容且默认可写的公共路径。
方法一：通过浏览器设置直接修改（v5.9.0及以上适用）
1、悟空浏览器右下角点「我的」→ 右上角齿轮图标进「设置」；
2、滑动找到「下载管理」→ 点「默认下载路径」；
3、点击当前路径 → 顶部选「内部存储」→ 进入「Download」文件夹 → 确认保存。
在 Linux 上通过 Chrome 挂载/VNC 自动发布小红书长笔记。Agent 撰写标题和正文后执行 xhs_publish.sh --publish --submit，触发小红书发布。
方法二：用文件管理器手动创建可写路径（旧版本或设置入口失效时）
1、用Solid Explorer打开 /storage/emulated/0/Download/；
2、新建文件夹，命名为 WK_Downloads；
3、返回浏览器设置，把默认路径手动改成 /storage/emulated/0/Download/WK_Downloads；
4、保存后立刻测试下载。
临时关闭广告拦截与安全扩展
悟空浏览器内置的广告过滤模块常把含 /download/、?file= 或 .apk/.exe 后缀的URL误判为恶意跳转，直接丢弃请求头，导致点击无响应。
第一步：快速禁用核心拦截开关
1、地址栏输入 about:adblock 回车 → 进入广告过滤设置页；
2、关闭「下载链接保护」和「增强型安全防护」；
3、刷新原下载页，再点链接。
第二步：精准添加白名单（适合网盘类站点）
① 点右下角菜单 →「设置」→「隐私与安全」→「广告拦截」→「白名单」；
② 输入完整域名，例如 https://pan.baidu.com（注意必须带 https://，不能带路径）；
③ 保存后刷新网页，下载按钮通常会立刻恢复显示。
提取真实直链并用ADM接管下载
当上述操作仍失败，说明目标文件链接本身已过期或被动态token保护，浏览器无法自动续传。此时必须绕过浏览器下载引擎，交由专业工具处理。
1、在视频/PDF下载页长按空白处 → 选「查看网页源代码」；
2、用页面搜索功能（Ctrl+F）输入 .mp4 或 .pdf，找到最新一行完整URL；
3、长按该链接 →「复制」；
4、打开ADM（Advanced Download Manager）→ 点「+」→「粘贴链接」→ 选择保存路径为 /storage/emulated/0/Download/；
5、启动下载，ADM会自动处理重定向、分片和断点续传。
