APK 下载完了却找不到文件:分区存储、下载目录与 adb 逐层定位
下载进度条走完、通知栏显示「下载完成」,打开文件管理器进 Download 却空空如也——这类反馈很容易被当成「文件丢了」,于是反复重下、清缓存,甚至怀疑手机存储坏了。但绝大多数情况下文件并没有消失,只是没有落在你以为的目录,或者没有被登记进你能查询的索引。
APK 恰好是最容易踩中这件事的一类文件:体积大、常被浏览器和下载器改名、又正好落在 Android 存储模型改动最频繁的 Download 集合里。从 Android 10 开始,「文件存在」和「文件对别的应用可见」彻底变成了两件事。理解这一点,排查就从瞎找变成了有顺序的四五条命令。
先划清边界:本文只处理「文件其实还在,但你找不到」。如果你已经用全盘搜索确认它不存在、或者被清理工具删掉了,那是另一条路径,请直接看 APK 文件被误删了还能找回吗。
先分清四种「找不到」
同样是「找不到」,背后的原因与处置完全不同。先对号入座,能省掉大量无效重下。
| 你看到的现象 | 最可能的原因 | 第一条验证命令 |
|---|---|---|
| 下载完成,Download 目录是空的 | 文件落在应用私有目录,或写进了 MediaStore 的 Downloads 集合但物理路径不在 /sdcard/Download | adb shell content query --uri content://media/external/downloads --projection _id:_display_name:size:relative_path |
全局搜 *.apk 没有任何结果 | 扩展名被改成 .bin / .download / .1,或只是大小写差异 | adb shell find /sdcard -iname "*apk*" -o -iname "*.bin" |
| 文件管理器里能看到,adb 里路径却对不上 | 分区存储下 _data 列不再是权威路径,显示的是映射后的沙盒路径 | adb shell content query --uri content://media/external/downloads --projection _data:relative_path |
| 有这个文件,但 0 字节或体积明显偏小 | 下载被截断、写盘失败,或只是一个占位文件 | adb shell ls -l /sdcard/Download/ 对照 curl -I 的 Content-Length |
前三类是索引、路径、命名问题,文件本身往往是好的;第四类是内容问题,文件是坏的。这两条路从第二步开始就分叉了,所以不要一上来就重装、重下。
机制:Android 究竟把下载文件放到了哪里
「下载到 Download 文件夹」这句常识,在 Android 10 之后只是近似正确。下面这张表是后面所有命令的依据。
| Android 版本 | 存储模型 | 对 APK 落盘的实际影响 | 排查要点 |
|---|---|---|---|
| 9 及以下 | 传统外部存储,任意应用可读写 /sdcard 公共目录 | 下载器基本都写 /sdcard/Download,文件管理器直接可见 | ls -la /sdcard/Download 基本够用 |
| 10 | 引入分区存储(Scoped Storage),但可用 requestLegacyExternalStorage=true 申请退回旧模型 | 同一台手机上,旧版下载器仍写公共目录,新版写 Downloads 集合,行为不一致 | 目录和 MediaStore 两处都要查 |
| 11 及以上 | 强制分区存储,退路取消;写公共下载区必须走 MediaStore 或系统下载管理器 | _data 可能为空,也可能只是一个逻辑路径,直接用它 open 会失败 | 以 content query 的结果为准,不要只信路径 |
| 12 至 13 | 下载集合归属系统下载提供程序,引入 relative_path 与 is_pending | 下载中 is_pending=1 时,文件对第三方应用不可见 | 顺带查 is_pending 和下载任务 status |
| 14 及以上 | 进一步收紧媒体权限,READ_MEDIA_* 只覆盖图片、视频、音频 | APK 归 downloads 集合,不受照片权限影响,但文件管理器若按类型筛选仍可能不显示 | 关掉文件管理器的类型筛选 |
需要分清两个常被混为一谈的东西:
content://media/external/downloads是 MediaStore 的下载集合,也就是媒体索引,字段有_id、_display_name、size、relative_path、_data、date_added、is_pending。content://downloads/public_downloads是系统下载管理器的任务记录,字段有title、status、total_size、current_bytes、uri。
前者回答「系统认为有哪些下载文件」,后者回答「那个下载任务到底成没成功」。下载器崩溃时,可能出现任务记录显示成功、但媒体索引里没有条目,或者反过来留下一条永远 is_pending=1 的记录。这正是「明明下完了却搜不到」最常见的机制解释。另外,_display_name 才是你该拿去搜的名字,relative_path 只是相对目录(例如 Download/);不少 ROM 上 _data 为空是完全正常的,不代表文件丢失。
第一层:先用 curl 把「正确样本」钉死
不要从手机开始找。先在电脑或任意一台能联网的机器上,把「本来应该拿到多大的文件」确定下来,后面才有比对基准。
curl -sI -L "https://example.com/app.apk" | grep -iE "^(HTTP/|content-length|content-disposition|content-type|accept-ranges)"四个字段各有用途:HTTP 状态确认链接有效;Content-Length 是期望字节数;Content-Disposition 决定下载器给文件起什么名字(缺失时最容易变成 .bin);Content-Type 影响类型判断;Accept-Ranges 则关系到能否断点续传。
接着拿一份本地样本:
curl -L --fail \
-o "$HOME/Desktop/app.apk" \
--write-out "http=%{http_code} size=%{size_download} time=%{time_total}\n" \
"https://example.com/app.apk"
shasum -a 256 "$HOME/Desktop/app.apk"
unzip -l "$HOME/Desktop/app.apk" | head -20把这份文件的大小和 SHA-256 记下来,它是后面判断手机上那个文件是否完整的唯一可靠依据。Android 上的 sha256sum 并非所有 ROM 都带,实在没有就 adb pull 回电脑再算。
这一层如果就出问题,说明根本不是「找不到文件」:拿到 403/404 或链接已失效,去 APK 下载链接 403 与失效排查;下到一半断开,看 下载中断怎么续传;速度只有几十 KB/s,看 三种限速来源与逐层测速法。
第二层:用 adb 定位真实的落盘位置
先确认系统版本,它决定该用哪套路径模型:
adb devices
adb shell getprop ro.build.version.release
adb shell id然后按下面四步走。
1)直接看公共目录
adb shell ls -la /sdcard/Download/
adb shell ls -la /storage/emulated/0/Download/两条路径通常指向同一处,不同 ROM 的挂载名可能不同。命中就跳到收口那一步。
2)不依赖扩展名地全盘模糊搜
adb shell find /sdcard -type f \( -iname "*.apk" -o -iname "*.bin" -o -iname "*.download" -o -iname "*.1" \) 2>/dev/null-iname 忽略大小写,2>/dev/null 屏蔽满屏的 Permission denied。少数精简 ROM 的 find 不支持 -o,降级成多次单条件搜索即可。把范围限制在 /sdcard 而不是从根开始,速度会快很多。
3)查 MediaStore 索引(最关键的一步)
adb shell content query --uri content://media/external/downloads \
--projection _id:_display_name:size:relative_path:_data:date_added:is_pending \
--sort "date_added DESC"典型输出形如 Row: 0 _id=1234, _display_name=app.apk, size=84231712, relative_path=Download/, _data=/storage/emulated/0/Download/app.apk, date_added=1763340000, is_pending=0。逐字段读:size 要拿来和 Content-Length 对;_display_name 才是搜索关键词;relative_path 告诉你它逻辑上属于哪个子目录;is_pending=1 表示这条记录还处于「下载中」,对别的应用不可见。
4)查下载任务记录
adb shell content query --uri content://downloads/public_downloads \
--projection _id:title:status:total_size:current_bytes:_data:uriDownloadManager 的 COLUMN_STATUS 是位标志,常见取值为 STATUS_PENDING=1、STATUS_RUNNING=2、STATUS_PAUSED=4、STATUS_SUCCESSFUL=8、STATUS_FAILED=16;部分厂商 provider 会直接返回 HTTP 状态码,所以更稳妥的判断是 current_bytes 是否等于 total_size,以及对应文件是否真的存在。注意很多 ROM 对 public_downloads 有读取限制,普通 adb shell 返回 No result found. 并不等于没有下载任务,此时以第 3 步的媒体索引为准。
别忘了多用户与工作资料
adb shell pm list users
adb shell ls -la /storage/emulated/10/Download/User 10 通常是工作资料或多用户空间,主空间的文件管理器看不到它。这与「装完找不到图标」是同一类空间隔离问题,可对照 桌面找不到图标的逐层排查。
第三层:应用私有目录与各家下载器的默认位置
同样是「下载」,不同来源写的位置并不一样。下面这张表能解释大部分「Download 里没有」的情况。
| 下载来源 | 常见包名 | 典型落盘位置 | 别的文件管理器能否看到 |
|---|---|---|---|
| Chrome | com.android.chrome | /sdcard/Download/,经系统下载管理器 | 通常能 |
| 系统下载管理器 | com.android.providers.downloads | MediaStore Downloads 集合 | 能,但按索引展示 |
| Firefox | org.mozilla.firefox | /sdcard/Download/ | 能 |
| 第三方下载器(ADM、1DM 一类) | 各异 | /sdcard/<应用名>/ 或自定义目录 | 能,但不在 Download 目录里 |
| 即时通讯、网盘类应用 | 各异 | /sdcard/Android/data/<包名>/files/... | Android 11 之后通常不能 |
| 应用内「保存到本地」 | 各异 | /data/user/0/<包名>/files/... | 只有 root 或 run-as 能看 |
adb shell ls -la /sdcard/Android/data/<包名>/files/
adb shell dumpsys package <包名> | grep -iE "download|external"
adb shell run-as <包名> ls -la files/Download/run-as 只对 debuggable 的应用有效,/data/data/... 需要 root。为了找一个 APK 去 root 手机并不划算——更简单的办法是让下载器把文件「分享/导出」到公共目录,或者干脆用第一层 curl 拿到的样本直接 adb push 到手机。
第四层:扩展名、MIME 与「假 APK」
服务端如果没给 Content-Disposition: attachment; filename="app.apk",或者只回了 Content-Type: application/octet-stream,下载器猜不出类型,就会自行追加 .bin、.download、.1 这类后缀。有些 CDN 还会在下载未完成时用 .download 标记临时文件,正常结束后才改名——进程被杀就会留下这个中间态。
先在服务端确认:
curl -sI -L "https://example.com/app.apk" | grep -iE "content-disposition|content-type|content-length"然后改名:
adb shell mv /sdcard/Download/app.bin /sdcard/Download/app.apk但改名不等于文件有效,必须再做三项校验:
# 1) APK 本质是 ZIP,前两个字节应为 PK
adb shell "head -c 4 /sdcard/Download/app.apk | xxd"
# 2) 结构完整:应能看到 AndroidManifest.xml、classes.dex、META-INF/
adb pull /sdcard/Download/app.apk /tmp/phone.apk
unzip -l /tmp/phone.apk | head -20
# 3) 与服务端样本比对哈希
shasum -a 256 /tmp/phone.apk "$HOME/Desktop/app.apk"三项都对得上,说明文件完好,问题纯粹在可见性或命名;size 与 Content-Length 不符、或者 ZIP 结构残缺,就是下载被截断,回到 续传 或 403/404 排查 重下。另外,即便哈希一致,只要来源是第三方镜像而非官方,仍建议做一次 APK 签名校验,确认包没有被重签。
第五层:索引没刷新、被清理工具删掉、被筛选隐藏
索引滞后。 老办法是发媒体扫描广播:
adb shell am broadcast \
-a android.intent.action.MEDIA_SCANNER_SCAN_FILE \
-d file:///sdcard/Download/app.apk但 Android 10 起这个广播已对第三方应用弃用,调用可能没有效果;更可靠的是让下载器重新通过 MediaStore 插入记录,或重启一次让系统重新扫描。不要为了刷新索引反复重装应用。
`is_pending` 残留。
adb shell content query --uri content://media/external/downloads \
--projection _id:_display_name:is_pending:relative_path如果一条记录长期为 1,多半是下载器中途崩溃。清除该下载器的缓存或重新下载,会重建一条正常的记录。
清理工具与安全软件。 不少「垃圾清理」把 .apk 列为可清理项,下载完几分钟就被删掉。判断依据:date_added 很新、find 全盘无结果、下载器历史里仍显示完成。确认属于这种情况,就转入 误删恢复,别再找了。
文件管理器筛选。 有些管理器默认只显示图片、视频、文档,或隐藏点号开头的文件。换成能显示「所有文件」的管理器,或者干脆以上面的 adb 结果为准。
MTP 连电脑看不到。 MTP 呈现的是 MediaStore 索引而不是真实目录树,索引未刷新时会出现「手机上有、电脑里没有」。断开重连、重启,或直接用 adb pull 取文件,都不依赖 MTP。
一条可以直接照做的判断顺序
curl -sI -L拿到Content-Length、Content-Disposition和Content-Type,再下载一份本地样本并记下 SHA-256,建立正确基准。adb shell getprop ro.build.version.release确定系统版本,选好对应的存储模型(10 是分界,11 是强制分区存储)。adb shell ls -la /sdcard/Download/;命中直接跳到第 7 步。adb shell content query --uri content://media/external/downloads ...;命中说明文件在索引里,记下_display_name、size、relative_path、is_pending。adb shell find /sdcard -iname "*apk*" -o -iname "*.bin";找到但名字怪,进第 6 步;全盘无结果,进第 8 步。- 校验 ZIP 魔数、内部结构和 SHA-256;一致就改名为
.apk,不一致就按截断处理重新下载。 - 用
adb install -r或adb push+pm install直接安装,绕开文件管理器收口。 - 全盘确实没有、且清理工具可疑 → 进入恢复流程。
- 安装成功但桌面没图标 → 与「找不到文件」无关,转 无图标排查。
绕开文件管理器:直接安装来收口
adb push "$HOME/Desktop/app.apk" /data/local/tmp/app.apk
adb shell pm install -r /data/local/tmp/app.apk
adb shell pm path com.example.app这一步的价值是证明包本身没问题,把「找不到文件」和「装不上」彻底分开。若 pm install 成功而桌面没图标,那是启动入口或用户空间的问题;若返回 INSTALL_FAILED_* 错误码,则属于安装阶段的问题,可对照 下载安装全流程检查清单 与 批量安装技巧。
常见问题(FAQ)
Q1:通知栏显示「下载完成」,Download 目录却是空的,是不是被删了?
大概率没有。Android 11 之后,下载器可能把文件写进 MediaStore 的 Downloads 集合,物理路径未必是 /sdcard/Download,也可能落在应用私有目录或另一个用户空间。先用 content query 查索引,再下删除的结论。
Q2:content query 返回 No result found. 说明什么?
说明当前用户空间的媒体索引里没有这条记录,不等于文件不存在。可能是 is_pending 记录、别的用户空间,或下载器写到了私有目录。继续用 find、pm list users 排查;部分 ROM 对 content://downloads/public_downloads 有权限限制,返回空属于正常现象。
Q3:文件找到了,点开却提示「解析包错误」,是没找到引起的吗?
不是,这是内容问题。用 ZIP 魔数、内部结构和 SHA-256 三项校验,通常是下载被截断或文件被改坏。参考 续传 与 403/404 排查。
Q4:手机上能看见,插电脑用 MTP 却看不到?
MTP 展示的是 MediaStore 索引而非真实目录结构,索引未刷新就会出现这种差异。用 adb pull 直接取文件,或重启让系统重新扫描。
Q5:.apk 变成 .bin 或 .download,直接改名就行吗?
改名只是第一步。先确认它是完整的 ZIP(PK 魔数、能列出 AndroidManifest.xml),并与服务端的 Content-Length 和 SHA-256 对齐。否则改了名也装不上。
Q6:Android 11 以上还能让下载器写到我指定的任意文件夹吗?
不能直接写公共目录的任意路径。应用需要通过 MediaStore 的 relative_path(例如 Download/MyApps/)或系统文件选择器 SAF 授权。这也是为什么新版本上「我明明设置了目录,却还是找不到」。
Q7:工作资料或多用户里的下载文件,主空间能看到吗?
不能。用 adb shell pm list users 看用户 ID,再查 /storage/emulated/<id>/Download/。这与「装完找不到图标」属于同一类空间隔离问题。
Q8:adb shell find 很慢,还一直报 Permission denied 怎么办?
把范围收窄到 /sdcard,加 2>/dev/null 屏蔽噪声,或用 -iname 直接匹配关键词。/data 与 /sdcard/Android/data 需要更高权限,普通排查不必进入。
一句话总结
「下载完成」只说明字节流走完了,不说明文件登记在你找得到的那个目录里。先用 curl 钉死正确样本,再用 adb 依次查公共目录、媒体索引、下载任务记录和私有空间,最后用 adb install 收口;只有全盘确实没有,才进入 误删恢复 那条路。