从内部存储获取PDF：无法列出设备所有PDF仅检索到图片问题咨询

核心问题原因 #

出现仅返回图片、无法检索到PDF的问题，90%以上的场景是三类错误：权限申请不完整、检索过滤规则漏配PDF相关条件、查询的资源索引仅覆盖图片类资源。

分场景解决方案 #

安卓原生开发场景 #

• 先确认权限配置正确
  • API 32及以下：确保已申请READ_EXTERNAL_STORAGE权限，不要仅申请图片相关的媒体权限
  • API 33及以上：如果需要扫描全量公共存储的PDF，需申请MANAGE_EXTERNAL_STORAGE权限；如果仅需要访问用户指定目录的PDF，可调用系统存储访问框架（SAF）无需申请全量存储权限
• 修正资源查询逻辑
  不要仅查询图片专属的MediaStore.Images.Media.EXTERNAL_CONTENT_URI索引，要使用全文件索引，同时过滤PDF的MIME类型，示例代码如下：

  // 配置返回的字段
  val projection = arrayOf(
      MediaStore.Files.FileColumns._ID,
      MediaStore.Files.FileColumns.DISPLAY_NAME,
      MediaStore.Files.FileColumns.DATA,
      MediaStore.Files.FileColumns.SIZE
  )
  // 过滤PDF格式
  val selection = "${MediaStore.Files.FileColumns.MIME_TYPE} = ?"
  val selectionArgs = arrayOf("application/pdf")
  // 查询全量文件索引
  val cursor = contentResolver.query(
      MediaStore.Files.getContentUri("external"),
      projection,
      selection,
      selectionArgs,
      "${MediaStore.Files.FileColumns.DATE_ADDED} DESC"
  )
  // 遍历cursor获取PDF文件信息即可
  

  如果需要同时检索图片和PDF，可修改过滤条件为${MediaStore.Files.FileColumns.MIME_TYPE} LIKE ? OR ${MediaStore.Files.FileColumns.MIME_TYPE} = ?，selectionArgs改为arrayOf("image/%", "application/pdf")

Python本地脚本检索场景 #

如果是PC/嵌入式设备用Python遍历存储，检查后缀过滤逻辑是否漏加PDF后缀，同时兼容大写后缀的情况：

import os

def get_all_pdf(root_path: str) -> list:
    pdf_files = []
    for root, _, files in os.walk(root_path):
        for file in files:
            # 兼容.PDF大写后缀
            if file.lower().endswith(".pdf"):
                pdf_files.append(os.path.join(root, file))
    return pdf_files

通用排查步骤 #

• 确认当前应用/脚本的读取权限覆盖了PDF所在的存储目录，不要仅授权了图片目录的访问权限
• 检查过滤规则：是否仅配置了.png/.jpg等图片后缀、image/*类图片MIME的过滤条件，漏加PDF的对应规则
• 检查查询的资源索引：是否仅查询了图片专属的媒体库索引，未覆盖文档类文件的索引

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