如何解决Android MediaStore无法识别Google照片创建的本地图像问题

现有实现存在三类存储适配缺陷，直接导致无法识别Google Photos创建的本地图片目录：

一、跨版本权限适配缺失 #

• Manifest仅声明READ_EXTERNAL_STORAGE权限，不满足高版本Android的权限要求：Android 13（API 33）起，READ_EXTERNAL_STORAGE不再具备媒体读取能力，读取图片必须单独申请READ_MEDIA_IMAGES细分权限；权限缺失时，系统会对应用隐藏所有第三方应用写入的媒体条目。
• 对Android 10-11（API 29-30）版本，未在Manifest中声明android:requestLegacyExternalStorage="true"属性，应用会被默认归入沙盒存储模式，即便保留旧权限，也无法访问非应用自身创建的媒体目录条目。

二、未遵循MediaStore的索引生成规则 #

MediaStore的全局条目库不是实时全磁盘扫描生成的，完全依赖文件写入方主动通知系统补全元数据：

• Google Photos执行本地文件移动、自建文件夹操作时，为避免云端同步的媒体文件被重复索引，不会主动向系统发送MediaScanner扫描请求。这些真实存在于磁盘上的文件，根本没有被同步到全局MediaStore数据库中，基于MediaStore的查询自然无法获取对应结果。
• 观察到使用Google Files操作后可正常检索，是因为Google Files在执行文件移动/复制操作时，会主动触发系统MediaScanner对操作涉及的文件路径做扫描，补上缺失的MediaStore条目，此时查询逻辑才能拿到结果。

三、查询逻辑存在数据源盲区 #

• 现有查询逻辑完全将MediaStore现有条目作为唯一数据源，没有做目录级别的校验补全：当MediaStore对Google Photos创建的Pictures子目录没有生成对应条目时，哪怕文件真实存在于磁盘，查询逻辑也没有兜底获取路径。
• 查询时仅拉取_ID、BUCKET_ID两个字段，没有校验条目的真实存储路径，既容易把应用私有缓存区的媒体条目误判为公共目录文件，也无法定位元数据缺失的目录。

1. 补齐全版本权限配置
   • Android 13及以上版本Manifest声明READ_MEDIA_IMAGES权限，保留旧版本的READ_EXTERNAL_STORAGE实现向下兼容
   • Android 10-11版本在<application>标签下补充android:requestLegacyExternalStorage="true"配置，关闭默认沙盒存储限制
2. 补充主动扫描逻辑
   应用初始化查询前，通过MediaScannerConnection.scanFile()主动触发系统对Pictures、DCIM核心图片目录的扫描，补全所有缺失的MediaStore条目，无需等待用户通过第三方文件管理器触发扫描。
3. 优化查询兜底机制
   • 查询时额外拉取RELATIVE_PATH字段，对扫描到的条目做路径合法性校验
   • 对MediaStore未索引到的Pictures子目录，通过SAF文档树权限获取Pictures根目录的访问权限，直接遍历目录下的真实图片文件补充到本地缓存，不要将MediaStore的现有条目作为唯一数据源。

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