Android中FilePicker使用报错：URI转File失败及修复咨询

错误原因分析 #

你遇到的CursorWindow无法读取行0列-1错误，是因为获取的content://com.android.providers.media.documents/document/image%3A28是媒体库提供的虚拟文档URI，并非真实文件路径。直接用旧的Cursor查询方式时，要么列名错误，要么Cursor为空，导致无法读取数据引发崩溃。

分步修复方案 #

1. 正确的URI转路径工具方法（兼容Android 7.0+） #

以下工具类会区分不同类型的URI，处理Cursor合法性检查，同时适配Android 10+的Scoped Storage限制：

import android.content.ContentResolver;
import android.content.ContentUris;
import android.content.Context;
import android.database.Cursor;
import android.net.Uri;
import android.os.Environment;
import android.provider.DocumentsContract;
import android.provider.MediaStore;
import android.util.Log;

import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.InputStream;

public class UriToFileUtil {

    public static File getFileFromUri(Context context, Uri uri) throws IOException {
        // 判断是否是媒体文档URI
        if (DocumentsContract.isDocumentUri(context, uri)) {
            String authority = uri.getAuthority();
            // 处理媒体库文档
            if ("com.android.providers.media.documents".equals(authority)) {
                String docId = DocumentsContract.getDocumentId(uri);
                String[] split = docId.split(":");
                String type = split[0];

                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;
                }

                String selection = "_id=?";
                String[] selectionArgs = new String[]{split[1]};

                String path = getDataColumn(context, contentUri, selection, selectionArgs);
                if (path != null) {
                    return new File(path);
                }
            }
            // 处理下载文档
            else if ("com.android.providers.downloads.documents".equals(authority)) {
                String id = DocumentsContract.getDocumentId(uri);
                Uri contentUri = ContentUris.withAppendedId(Uri.parse("content://downloads/public_downloads"), Long.parseLong(id));
                String path = getDataColumn(context, contentUri, null, null);
                if (path != null) {
                    return new File(path);
                }
            }
        }
        // 普通content URI（如直接从媒体库获取）
        else if ("content".equalsIgnoreCase(uri.getScheme())) {
            // Android 10+ 无法直接获取路径，复制到应用缓存目录
            if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.Q) {
                return copyFileToCache(context, uri);
            } else {
                return new File(getDataColumn(context, uri, null, null));
            }
        }
        // 文件URI
        else if ("file".equalsIgnoreCase(uri.getScheme())) {
            return new File(uri.getPath());
        }
        return null;
    }

    // 获取Cursor中的数据列
    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);
            if (cursor != null && cursor.moveToFirst()) {
                final int columnIndex = cursor.getColumnIndexOrThrow(column);
                return cursor.getString(columnIndex);
            }
        } catch (Exception e) {
            Log.e("UriToFileUtil", "getDataColumn error: " + e.getMessage());
        } finally {
            if (cursor != null) {
                cursor.close();
            }
        }
        return null;
    }

    // Android 10+ 将文件复制到应用缓存目录
    private static File copyFileToCache(Context context, Uri uri) throws IOException {
        InputStream inputStream = context.getContentResolver().openInputStream(uri);
        if (inputStream == null) return null;

        File cacheDir = context.getCacheDir();
        File tempFile = new File(cacheDir, System.currentTimeMillis() + "_temp_file");

        FileOutputStream outputStream = new FileOutputStream(tempFile);
        byte[] buffer = new byte[1024];
        int length;
        while ((length = inputStream.read(buffer)) > 0) {
            outputStream.write(buffer, 0, length);
        }

        inputStream.close();
        outputStream.close();
        return tempFile;
    }
}

2. Activity中正确调用（以Activity Result API为例） #

如果你的应用使用AndroidX的Activity Result API（推荐替代旧的onActivityResult），调用方式如下：

import android.content.Intent;
import android.net.Uri;
import android.os.Bundle;
import android.widget.Button;
import android.widget.Toast;

import androidx.appcompat.app.AppCompatActivity;
import androidx.activity.result.ActivityResultLauncher;
import androidx.activity.result.contract.ActivityResultContracts;

import java.io.File;
import java.io.IOException;

public class FilePickerActivity extends AppCompatActivity {

    private ActivityResultLauncher<Intent> filePickerLauncher;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_file_picker);

        // 注册文件选择器
        filePickerLauncher = registerForActivityResult(
                new ActivityResultContracts.StartActivityForResult(),
                result -> {
                    if (result.getResultCode() == RESULT_OK && result.getData() != null) {
                        Uri selectedUri = result.getData().getData();
                        try {
                            File file = UriToFileUtil.getFileFromUri(this, selectedUri);
                            if (file != null && file.exists()) {
                                // 成功获取到File对象，进行后续操作
                                Toast.makeText(this, "文件路径：" + file.getAbsolutePath(), Toast.LENGTH_LONG).show();
                            } else {
                                Toast.makeText(this, "无法获取文件", Toast.LENGTH_SHORT).show();
                            }
                        } catch (IOException e) {
                            e.printStackTrace();
                            Toast.makeText(this, "转换失败：" + e.getMessage(), Toast.LENGTH_SHORT).show();
                        }
                    }
                }
        );

        Button pickBtn = findViewById(R.id.pick_file_btn);
        pickBtn.setOnClickListener(v -> {
            Intent intent = new Intent(Intent.ACTION_OPEN_DOCUMENT);
            intent.addCategory(Intent.CATEGORY_OPENABLE);
            intent.setType("*/*"); // 允许选择所有类型文件，可根据需求修改
            filePickerLauncher.launch(intent);
        });
    }
}

3. 关键修复点 #

• Cursor合法性检查：读取Cursor前必须判断cursor != null && cursor.moveToFirst()，同时用getColumnIndexOrThrow替代直接索引，避免列不存在的错误。
• 区分URI类型：针对媒体库、下载目录等不同authority的URI做单独处理，避免统一查询导致的错误。
• 适配Scoped Storage：Android 10及以上系统禁止直接访问外部存储文件路径，通过将文件复制到应用私有缓存目录的方式获取可用的File对象。

注意事项 #

• 确保在AndroidManifest.xml中添加必要的权限：

  <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
  <!-- Android 13+ 需添加对应媒体权限 -->
  <uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
  <uses-permission android:name="android.permission.READ_MEDIA_VIDEO" />
  <uses-permission android:name="android.permission.READ_MEDIA_AUDIO" />
  

• 复制到缓存目录的临时文件，记得在使用完成后删除，避免占用存储空间。

内容的提问来源于stack exchange，提问作者Dr.KeyOk