Android技术问题：ADB上传的图片无法通过MediaStore API（SDK31）识别

核心原因 #

在Android 12（SDK 31）的分区存储机制下，ADB/Android Studio上传的文件不会自动触发MediaStore的媒体库扫描，导致这些文件未被系统媒体数据库索引；另外如果你的查询代码额外过滤了应用自身创建的文件，也会看不到外部传入的内容。

具体解决方案 #

1. 触发媒体库扫描，让系统索引新上传的文件 #

ADB上传文件后，系统不会自动扫描新增内容，需要手动触发扫描。可以用MediaScannerConnection扫描目标文件或整个目录：

Java 代码示例

// 扫描指定目录下的所有文件
MediaScannerConnection.scanFile(getApplicationContext(),
        new String[]{Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_PICTURES) + "/你的文件夹名/"},
        null,
        (filePath, contentUri) -> {
            // 扫描完成后的回调，可在此重新查询MediaStore
        });

Kotlin 代码示例

MediaScannerConnection.scanFile(applicationContext,
    arrayOf(Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_PICTURES).toString() + "/你的文件夹名/"),
    null) { filePath, contentUri ->
    // 扫描完成后执行查询逻辑
}

2. 检查MediaStore查询代码，移除不必要的过滤条件 #

如果你的查询语句中添加了OWNER_PACKAGE_NAME过滤（只查询当前应用创建的文件），会导致看不到外部传入的内容。确保查询逻辑没有这类限制：

错误示例（会过滤掉外部文件）

String selection = MediaStore.Images.Media.OWNER_PACKAGE_NAME + " = ?";
String[] selectionArgs = {getPackageName()};
Cursor cursor = getContentResolver().query(
        MediaStore.Images.Media.EXTERNAL_CONTENT_URI,
        projection,
        selection,
        selectionArgs,
        null);

正确示例（查询所有图片文件）

String[] projection = {
        MediaStore.Images.Media._ID,
        MediaStore.Images.Media.DISPLAY_NAME,
        MediaStore.Images.Media.DATA
};
Cursor cursor = getContentResolver().query(
        MediaStore.Images.Media.EXTERNAL_CONTENT_URI,
        projection,
        null,
        null,
        null);

3. 确认文件上传路径的正确性 #

确保ADB上传的文件是存放在公共Pictures目录（/storage/emulated/0/Pictures/你的文件夹/），而非应用私有目录（/Android/data/你的包名/files/Pictures/）。后者属于应用私有存储，外部上传的文件无法被应用通过MediaStore访问。

4. 验证权限配置 #

确认已正确申请并获取READ_EXTERNAL_STORAGE权限（SDK 31无需READ_MEDIA_IMAGES）：

• 在Manifest中声明：

  <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
  

• 动态申请权限（Android 6.0+要求）：

  if (ContextCompat.checkSelfPermission(this, Manifest.permission.READ_EXTERNAL_STORAGE)
          != PackageManager.PERMISSION_GRANTED) {
      ActivityCompat.requestPermissions(this,
              new String[]{Manifest.permission.READ_EXTERNAL_STORAGE},
              REQUEST_CODE_READ_STORAGE);
  }
  

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