从URL获取XLSX文件完整路径时遇Missing volume name异常

错误java.lang.IllegalArgumentException: Missing volume name的核心原因是：你传入的Uri是系统文件选择器返回的DocumentsProvider封装Uri（格式如content://com.android.providers.media.documents/document/document%3A1000000004），而MediaStore.getVolumeName(uri)只能处理直接的MediaStore Uri，无法从这类封装Uri中提取卷名。

可行解决方案 #

1. 解析DocumentsProvider Uri获取真实MediaStore Uri

拆分DocumentsProvider的文档ID，从中提取卷名和文件ID，再构建合法的MediaStore Uri：

if ("document".equals(type)) {
    String documentId = DocumentsContract.getDocumentId(uri);
    String[] parts = documentId.split(":");
    if (parts.length == 2) {
        // 多数情况下parts[0]为"primary"，对应MediaStore的"external"卷名
        String volumeName = "external";
        long fileId = Long.parseLong(parts[1]);
        contentUri = MediaStore.Files.getContentUri(volumeName, fileId);
    }
}

2. 跳过路径直接读取文件流（推荐）

Android 10+引入Scoped Storage后，不建议依赖真实文件路径，直接通过ContentResolver打开输入流处理XLSX文件即可：

// 直接获取文件输入流
InputStream inputStream = getContentResolver().openInputStream(uri);
// 后续用POI等库解析XLSX，示例：
// XSSFWorkbook workbook = new XSSFWorkbook(inputStream);

3. 用DocumentFile封装Uri操作文件

通过DocumentFile直接操作文件，无需解析路径：

if ("document".equals(type)) {
    DocumentFile documentFile = DocumentFile.fromSingleUri(context, uri);
    if (documentFile != null && documentFile.exists()) {
        // 可直接通过documentFile获取文件名、大小，或打开流
        String fileName = documentFile.getName();
        InputStream stream = getContentResolver().openInputStream(documentFile.getUri());
    }
}

注意事项 #

• Android 12及以下需提前申请READ_EXTERNAL_STORAGE权限；Android 13+针对媒体文件可申请更细分的权限（如READ_MEDIA_IMAGES/READ_MEDIA_VIDEO/READ_MEDIA_AUDIO）。
• 避免使用MANAGE_EXTERNAL_STORAGE权限，除非你的应用是文件管理器类应用，否则会影响上架。

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