存储与多媒体问题排查：索引、权限与播放

前五章把存储与多媒体机制讲完了。这一章把它们串成排障链：媒体查不到、文件访问被拒、 播放失败、音频异常，按什么顺序查。

文件存在但查询不到，先查 MediaStore 索引；路径可见但打开失败，再查权限与 FUSE；播放 已经进入 MediaCodec 后失败，则转向提取、解码、同步和输出服务，避免跨层猜测。

先判断问题在文件、索引、权限还是播放链

常见误解	正确理解
文件读不到就是没权限	可能是索引缺失、路径错误、FUSE 或服务问题
播放失败就是文件损坏	可能是提取、解码、同步或输出任一段
多媒体问题都在应用层	索引、服务、HAL 都可能

核心结论

1. 排障顺序：存储视图 → 媒体索引 → 权限 → 服务与管线。
2. 媒体查不到先确认文件在不在、索引有没有、权限够不够。
3. 播放失败按提取、解码、同步、输出分阶段。
4. 音频异常先看焦点与路由，再看服务。
5. 修复后回归：重复操作确认索引与播放正常。

排障主链

逐步解释：

1. 文件层：确认文件是否存在、路径与视图正确。
2. 索引层：确认 MediaStore 是否有记录。
3. 权限层：确认媒体权限与访问方式。
4. 管线层：确认服务与播放器状态。

常用命令与证据

环境：开发设备或模拟器；以下命令不需要 root。

adb shell ls -l /storage/emulated/0/Pictures/
adb shell content query --uri content://media/external/images/media --projection _id:_display_name
adb shell dumpsys package <包名> | grep -E "READ_MEDIA|MANAGE_EXTERNAL"
adb shell dumpsys media.player
adb shell dumpsys audio
adb logcat -v threadtime | grep -E "MediaProvider|MediaCodec|NuPlayer|AudioService"

证据	回答的问题
ls 外部目录	文件是否存在
content query	是否被索引
dumpsys package	权限授予
media.player	播放状态
logcat 关键字	失败阶段

常见场景与定位思路

场景一：媒体文件读不到

先确认文件在磁盘，再查 MediaStore 索引，最后查权限。三层都过仍不行，看 MediaProvider 扫描日志。

场景二：播放失败

按提取、解码、同步、输出分阶段看 logcat。解码失败查 MediaCodec 与编解码器； 输出失败查 Surface 与音频服务。

场景三：音频没有声音

先看音频焦点与路由（dumpsys audio），再确认输出设备与音量。焦点被抢是“突然没声” 的高频原因。

场景四：相机打不开

先查权限与会话，再看 CameraService 与 HAL 日志。相机问题常涉及权限、占用与 硬件资源。

常见误区

1. “读不到就是没权限”：按四层定位。
2. “播放失败就是文件坏”：分阶段看日志。
3. “媒体问题都在应用层”：索引与服务同样可能。
4. “焦点问题忽略即可”：会导致“没声音”误判。

延伸问题

1. 如何自动化验证媒体索引与权限？
2. 编解码失败如何区分软硬解？
3. 音频路由异常如何复现与定位？
4. 存储与媒体的测试矩阵怎么设计？

源码入口

文件	关键位置	作用
packages/providers/MediaProvider/	索引	媒体库
MediaCodec.java	解码	编解码
AudioService.java	焦点/路由	音频策略
dumpsys media.player	状态	播放排障

公共路径沿用本系列各章。行号以 r75 检索为准。

需要扩展到系统服务状态时，见 系统调试与排障。