Content Resolver无法找到图片文件问题排查求助

我在实现图片上传服务器功能时，使用以下代码获取图片路径，但遇到cursor.moveToFirst()返回false的问题，选中的图片URI为content://com.android.providers.media.documents/document/image%3A1000025026，不确定是Intent还是内容查询环节出问题，需要排查解决。

获取图片路径的代码 #

public static String getPath(final Context context, final Uri uri) {
    // DocumentProvider
    try {
        if (DocumentsContract.isDocumentUri(context, uri)) {
            // ExternalStorageProvider
            if (isExternalStorageDocument(uri)) {
                Log.e(TAG, "Content URI -> External : " + uri);
                final String docId = DocumentsContract.getDocumentId(uri);
                final String[] split = docId.split(":");
                final String type = split[0];
                Log.e(TAG, "Type: " + type);
                if ("primary".equalsIgnoreCase(type)) {
                    return Environment.getExternalStoragePublicDirectory(type) + "/" + split[1];
                }

            }
            // DownloadsProvider
            else if (isDownloadsDocument(uri)) {
                Log.e(TAG, "Content URI -> Downloads : " + uri);
                final String id = DocumentsContract.getDocumentId(uri);
                final Uri contentUri = ContentUris.withAppendedId(
                        Uri.parse("content://downloads/public_downloads"), Long.valueOf(id));
                Log.e(TAG, "Content uri: " + contentUri);

                return getDataColumn(context, contentUri, null, null);
            }
            // MediaProvider
            else if (isMediaDocument(uri)) {
                final String docId = DocumentsContract.getDocumentId(uri);
                final String[] split = docId.split(":");
                final String type = split[0];
                Log.e(TAG, "Type : " + type);
                Uri contentUri = null;
                if ("image".equals(type)) {
                    contentUri = MediaStore.Images.Media.EXTERNAL_CONTENT_URI;
                } else if ("video".equals(type)) {
                    contentUri = MediaStore.Video.Media.EXTERNAL_CONTENT_URI;
                } else if ("audio".equals(type)) {
                    contentUri = MediaStore.Audio.Media.EXTERNAL_CONTENT_URI;
                }

                final String selection = "_id=?";
                final String[] selectionArgs = new String[]{
                        split[1]
                };
                return getDataColumn(context, contentUri, selection, selectionArgs);
            }
        }
        // MediaStore (and general)
        else if ("content".equalsIgnoreCase(uri.getScheme())) {
            Log.e(TAG, "Content URI -> Content : " + uri);
            // Return the remote address
            if (isGooglePhotosUri(uri))
                return uri.getLastPathSegment();
            return getDataColumn(context, uri, null, null);
        }
        // File
        else if ("file".equalsIgnoreCase(uri.getScheme())) {
            return uri.getPath();
        }
    } catch (Exception e) {
        e.printStackTrace();
    }

    return null;
}

private static String getDataColumn(Context context, Uri uri, String selection, String[] selectionArgs) {
    Cursor cursor = null;
    final String column = "_data";
    final String[] projection = {column};

    try {
        cursor = context.getContentResolver().query(uri, projection, selection, selectionArgs,
                null);
        Log.e(TAG, "cursor.moveToFirst() : " + cursor.moveToFirst());
        if (cursor != null && cursor.moveToFirst()) {
            final int index = cursor.getColumnIndexOrThrow(column);
            return cursor.getString(index);
        }
    } finally {
        if (cursor != null)
            cursor.close();
    }
    return null;
}

调用图片选择的Intent代码 #

public static Intent getPickImageChooserIntent(Context context) {
    List<Intent> allIntents = new ArrayList<>();
    PackageManager packageManager = context.getPackageManager();
    // collect all gallery intents
    Intent galleryIntent = new Intent(Intent.ACTION_GET_CONTENT);
    galleryIntent.setType("image/*");
    List<ResolveInfo> listGallery = packageManager.queryIntentActivities(galleryIntent, 0);
    for (ResolveInfo res : listGallery) {
        Intent intent = new Intent(galleryIntent);
        intent.setComponent(new ComponentName(res.activityInfo.packageName, res.activityInfo.name));
        intent.setPackage(res.activityInfo.packageName);
        allIntents.add(intent);
    }

    // the main intent is the last in the  list (fucking android) so pickup the useless one
    Intent mainIntent = allIntents.get(allIntents.size() - 1);
    for (Intent intent : allIntents) {
        if (intent.getComponent() != null && DOCUMENT_APP_PATH.equalsIgnoreCase(intent.getComponent().getClassName())) {
            mainIntent = intent;
            break;
        }
    }
    allIntents.remove(mainIntent);

    // Create a chooser from the main  intent
    Intent chooserIntent = Intent.createChooser(mainIntent, context.getString(R.string.choose_image_text));
    // Add all other intents
    chooserIntent.putExtra(Intent.EXTRA_INITIAL_INTENTS, allIntents.toArray(new Parcelable[allIntents.size()]));

    return chooserIntent;
}

问题排查与解决方案 #

核心原因分析 #

你的URI属于MediaProvider文档类型，代码会进入isMediaDocument分支，构造MediaStore.Images.Media.EXTERNAL_CONTENT_URI并以_id=1000025026为条件查询，但cursor.moveToFirst()返回false，说明查询无结果，可能的原因：

1. 分区存储限制：Android 10及以上系统中，_data列被隐藏，直接查询无法获取有效数据，这是系统层面的限制。
2. 权限缺失：未申请读取外部存储的权限（Android 9及以下需要READ_EXTERNAL_STORAGE，Android 10+即使申请该权限也无法直接访问_data）。
3. Intent逻辑冗余：自定义的Intent构造逻辑过于复杂，可能筛选出的应用返回的URI存在兼容性问题，导致后续查询失败。

解决方案 #

方案1：官方推荐 - 直接使用输入流读取文件（优先选择）

从Android 10开始，官方不推荐直接获取文件绝对路径，建议通过ContentResolver打开输入流读取文件内容，完美适配所有版本，且无需处理路径兼容性问题：

public static InputStream getImageInputStream(Context context, Uri uri) throws IOException {
    return context.getContentResolver().openInputStream(uri);
}

上传服务器时，直接将该输入流写入请求体即可，彻底规避路径相关的所有问题。

方案2：修复路径获取逻辑（仅兼容Android 9及以下或已申请特殊权限）

如果必须获取绝对路径，需做以下调整：

• 确认isMediaDocument方法实现正确：

private static boolean isMediaDocument(Uri uri) {
    return "com.android.providers.media.documents".equals(uri.getAuthority());
}

• Android 10+需申请MANAGE_EXTERNAL_STORAGE权限（需用户手动开启，且Google Play对该权限的使用有严格限制），并确保已在Manifest中声明：

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

• 注意：即使获取到_data路径，在Android 10+中可能是应用沙箱内的路径，无法直接通过File类访问。

方案3：简化Intent构造逻辑

自定义的Intent筛选逻辑可能引入兼容性问题，简化为标准的图片选择Intent测试：

public static Intent getPickImageChooserIntent(Context context) {
    Intent intent = new Intent(Intent.ACTION_GET_CONTENT);
    intent.setType("image/*");
    intent.addCategory(Intent.CATEGORY_OPENABLE);
    return Intent.createChooser(intent, context.getString(R.string.choose_image_text));
}

简化后再测试是否还会出现查询无结果的问题，排除Intent层面的因素。

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