Android 13（Redmi Note 10S）中ACTION_OPEN_DOCUMENT抛出ActivityNotFoundException问题排查

问题场景 #

需求为让用户从设备图库选择单张JPEG格式图片，采用ActivityResultContracts.OpenDocument实现，同时添加try/catch降级到startActivityForResult的方案，但仍出现ActivityNotFoundException崩溃。

原代码 #

ActivityResultLauncher<String[]> galleryActivityLauncher = registerForActivityResult(new ActivityResultContracts.OpenDocument(), picked -> {
    if (picked != null) {
        processPickedImage(picked);
    }
});

try {
    galleryActivityLauncher.launch(new String[]{"image/jpeg"});
} catch (ActivityNotFoundException e) {
    // 降级到旧方案
    Intent intent = new Intent(Intent.ACTION_OPEN_DOCUMENT);
    intent.addCategory(Intent.CATEGORY_OPENABLE);
    intent.setType("image/jpeg");
    startActivityForResult(intent, REQUEST_CODE_GALLERY);
}

崩溃日志 #

Fatal Exception: android.content.ActivityNotFoundException: No Activity found to handle Intent { act=android.intent.action.OPEN_DOCUMENT cat=[android.intent.category.OPENABLE] typ=image/jpeg }
   at android.app.Instrumentation.checkStartActivityResult(Instrumentation.java:2220)
   at android.app.Instrumentation.execStartActivity(Instrumentation.java:1859)
   at android.app.Activity.startActivityForResult(Activity.java:5623)
   at androidx.activity.ComponentActivity.startActivityForResult(ComponentActivity.java:754)
   at android.app.Activity.startActivityForResult(Activity.java:5576)
   at androidx.activity.ComponentActivity.startActivityForResult(ComponentActivity.java:735)

原因分析 #

1. Intent匹配范围过窄：仅指定image/jpeg类型，部分图库应用可能仅注册了image/*的Intent Filter，导致无法匹配到可用Activity。
2. 定制ROM或应用适配问题：部分Android 13定制ROM可能移除了支持ACTION_OPEN_DOCUMENT的默认图库应用，或第三方图库未适配该Intent Action。
3. try/catch逻辑无效：ActivityResultContracts.OpenDocument的launch()方法内部已处理ActivityNotFoundException，不会向外抛出异常，因此catch块不会被触发。用户遇到的崩溃实际是降级代码被错误执行（或极端场景下launch抛出异常），而降级Intent同样无法找到匹配Activity。

可行替代方案 #

方案1：使用ACTION_GET_CONTENT #

ACTION_GET_CONTENT兼容性更广，几乎所有图库应用都支持，适合一次性获取图片的场景。代码示例：

Intent intent = new Intent();
intent.setType("image/*");
intent.setAction(Intent.ACTION_GET_CONTENT);
// 启动前先检查是否有应用能处理Intent
if (intent.resolveActivity(getPackageManager()) != null) {
    startActivityForResult(intent, REQUEST_CODE_LOAD_IMAGE);
} else {
    Toast.makeText(this, "未找到可用的图片选择应用", Toast.LENGTH_SHORT).show();
}

方案2：放宽类型限制并增加前置检查 #

保持使用ACTION_OPEN_DOCUMENT，但放宽类型为image/*，并在启动前检查是否有Activity能处理Intent：

// 更新ActivityResultLauncher逻辑
ActivityResultLauncher<String[]> galleryActivityLauncher = registerForActivityResult(new ActivityResultContracts.OpenDocument(), picked -> {
    if (picked != null) {
        processPickedImage(picked);
    } else {
        Toast.makeText(this, "无法选择图片", Toast.LENGTH_SHORT).show();
    }
});

// 用image/*替代image/jpeg，扩大匹配范围
galleryActivityLauncher.launch(new String[]{"image/*"});

// 若仍需降级方案，需先检查Intent可用性
Intent fallbackIntent = new Intent(Intent.ACTION_OPEN_DOCUMENT);
fallbackIntent.addCategory(Intent.CATEGORY_OPENABLE);
fallbackIntent.setType("image/*");
if (fallbackIntent.resolveActivity(getPackageManager()) != null) {
    // 执行降级逻辑
} else {
    // 提示用户或切换到ACTION_GET_CONTENT
}

方案3：提示用户安装适配应用 #

如果必须使用ACTION_OPEN_DOCUMENT，当检测到无匹配Activity时，提示用户安装支持存储访问框架(SAF)的图库应用（如Google相册）。

ACTION_OPEN_DOCUMENT与ACTION_GET_CONTENT的核心区别 #

• ACTION_OPEN_DOCUMENT：属于存储访问框架(SAF)，针对设备上已存在的文件，可通过takePersistableUriPermission获取长期访问权限，适合需要持续访问文件的场景。
• ACTION_GET_CONTENT：偏向获取数据片段，不一定对应真实文件（如相机即时拍摄的内容），仅提供临时访问权限，兼容性更好，适合一次性获取内容的场景。

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