使用ACTION_GET_CONTENT选取图片返回null URI的通用适配问题

云原生阿岚

2026-9-25

问题根因

意图配置错误：Intent.CATEGORY_OPENABLE 是意图类别，并非可通过 putExtra 传递的参数，部分厂商的系统选择器无法识别错误配置的参数，导致返回结果异常
ROM兼容问题：三星、摩托罗拉等部分定制ROM的相册/文件选择器，即使用户单选图片，也可能将选中结果存放在ClipData中而非直接通过Intent.getData()返回，偶发问题通常和用户选择图片的入口有关（比如从最近文件、云缓存入口选择时容易触发）
EXTRA_LOCAL_ONLY 配置限制：部分厂商将相册缓存、云同步本地镜像的文件标记为非纯本地文件，设置该参数为true时会导致读取失败

修复代码

1. 修正意图启动逻辑

Intent intent = new Intent();
intent.setType("image/*");
intent.setAction(Intent.ACTION_GET_CONTENT);
intent.putExtra(Intent.EXTRA_ALLOW_MULTIPLE, false);
// 移除错误的EXTRA传参，改用addCategory添加可打开类别
intent.addCategory(Intent.CATEGORY_OPENABLE);
// 若确实需要限制仅本地文件，可后续拿到Uri后再校验，避免厂商ROM识别错误
// intent.putExtra(Intent.EXTRA_LOCAL_ONLY, true);
startActivityForResult(Intent.createChooser(intent, getString(R.string.select_pic)), SELECT_IMAGE);

2. 修正结果读取逻辑

@Override
public void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    if(resultCode == RESULT_OK && requestCode == SELECT_IMAGE && data != null) {
        Uri uri = data.getData();
        // 若getData为空，尝试从ClipData读取结果
        if (uri == null && data.getClipData() != null && data.getClipData().getItemCount() > 0) {
            uri = data.getClipData().getItemAt(0).getUri();
        }
        if (uri != null) {
            // 后续业务逻辑
        }
    }
}