Jetpack Photo Picker相册文件夹缺失问题求助

核心原因分析 #

Jetpack的PickVisualMedia/PickMultipleVisualMedia默认依赖系统的媒体库索引机制，只有被媒体库成功扫描索引到的文件夹才会在选择器中显示。系统图库能显示全部文件夹，大概率是因为它直接读取了文件系统目录，而MediaPicker API严格遵循媒体库的索引结果。

可行解决方案 #

1. 触发媒体库重新扫描目标文件夹 #

如果你的文件夹是应用私有目录外的公共存储文件夹，可以通过发送广播让媒体库重新扫描：

val mediaScanIntent = Intent(Intent.ACTION_MEDIA_SCANNER_SCAN_FILE)
mediaScanIntent.data = Uri.fromFile(File(yourFolderPath))
sendBroadcast(mediaScanIntent)

Android 10及以上推荐使用MediaStoreAPI避免文件路径权限问题：

val contentValues = ContentValues().apply {
    put(MediaStore.Images.Media.RELATIVE_PATH, yourRelativePath) // 示例："Pictures/YourCustomFolder/"
    put(MediaStore.Images.Media.IS_PENDING, 1)
}
// 插入临时条目触发扫描，之后可删除该条目
val uri = contentResolver.insert(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, contentValues)
contentResolver.update(uri, ContentValues().apply { put(MediaStore.Images.Media.IS_PENDING, 0) }, null, null)

2. 自定义文件选择器（绕过系统MediaPicker限制） #

如果媒体库扫描无法解决问题，或需要访问应用私有目录内的图片，可以自行实现文件选择器：

• 使用StorageAccessFramework的ACTION_OPEN_DOCUMENT_TREE让用户选择文件夹，再遍历目录下的图片文件
• 结合DocumentFile读取目录内容，筛选出.jpg/.png等格式文件
• 优势是完全可控显示的文件夹和文件，不受媒体库索引限制

3. 检查权限与文件夹属性 #

• 确保应用已申请READ_MEDIA_IMAGES权限（Android 13+）或READ_EXTERNAL_STORAGE权限（Android 12及以下）
• 确认目标文件夹不是隐藏目录（目录名以.开头），媒体库默认不扫描此类目录
• 检查文件夹是否被定制ROM的媒体库排除，部分厂商会自动过滤某些目录

额外说明 #

Jetpack的MediaPicker API是对系统媒体选择器的封装，显示内容完全依赖系统媒体库状态，不同品牌ROM的媒体库扫描规则可能存在差异，这也是系统图库与MediaPicker显示不一致的常见原因。

内容的提问来源于stack exchange，提问作者BQF