Android开发中通过image uri获取图片真实路径返回null如何解决

• 问题场景：调用Uri转文件真实路径逻辑时，传入content://com.android.providers.media.documents/document/image%3A102173格式的媒体文档Uri，最终返回结果为null
• 问题根因：

现有参考实现存在两个兼容性缺陷：

1. 未正确解析com.android.providers.media.documents授权的Uri结构，没有处理类型:媒体id格式的document id拆分逻辑
2. 未适配Android 10+分区存储规则，直接查询DATA字段、未做权限兼容的情况下很容易返回空值

修复逻辑 #

在原有Uri解析的分支中，补充媒体文档Provider的专门处理代码：

// 识别媒体文档Provider分支
if ("com.android.providers.media.documents".equals(uri.getAuthority())) {
    String docId = DocumentsContract.getDocumentId(uri);
    String[] idSplit = docId.split(":");
    String mediaType = idSplit[0];
    String mediaRowId = idSplit[1];
    Uri mediaQueryUri = null;
    // 根据媒体类型匹配对应的媒体库查询Uri
    switch (mediaType) {
        case "image":
            mediaQueryUri = MediaStore.Images.Media.EXTERNAL_CONTENT_URI;
            break;
        case "video":
            mediaQueryUri = MediaStore.Video.Media.EXTERNAL_CONTENT_URI;
            break;
        case "audio":
            mediaQueryUri = MediaStore.Audio.Media.EXTERNAL_CONTENT_URI;
            break;
    }
    String selection = "_id = ?";
    String[] selectionArgs = new String[]{mediaRowId};
    // 走通用的内容查询列逻辑拿路径
    return queryFilePathFromContentUri(context, mediaQueryUri, selection, selectionArgs);
}

注意事项 #

• Android 10及以上版本系统受分区存储限制，MediaStore.MediaColumns.DATA字段可能始终返回null，这种场景下不要强制获取真实路径，直接通过ContentResolver.openInputStream(uri)获取文件流读取内容，兼容性远高于路径查找方案
• 执行查询前确认已申请对应读媒体权限：Android 13及以上需要READ_MEDIA_IMAGES/READ_MEDIA_VIDEO权限，Android 12及以下需要READ_EXTERNAL_STORAGE权限，无权限时所有媒体库查询都会返回空
• 不要硬编码拼接存储根路径，不同厂商系统的媒体文件存放目录存在定制差异，硬编码会导致大量机型适配问题

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