使用MediaStore加载Android图片时cursor.getString触发空指针异常

我来帮你搞定这个cursor.getString(dataColumnIndex)触发的空指针问题，咱们从几个常见的排查方向入手：

1. 先确认Cursor是否有有效数据 #

你的代码里直接调用cursor.moveToFirst()后就去取数据，但如果Cursor为空或者设备里没有任何图片数据，moveToFirst()会返回false，这时候后续的getString()必然会抛空指针。

修复代码：用while循环遍历Cursor，同时先判断Cursor的有效性，还可以用try-with-resources自动关闭Cursor避免内存泄漏：

public void getImages(Context context) {
    File imageFile;
    final String[] columns = {MediaStore.Images.Media.DATA, MediaStore.Images.Media._ID};
    String orderBy = MediaStore.Images.Media.DATE_MODIFIED + " DESC"; // 加上DESC按最新排序更合理
    
    try (Cursor cursor = context.getContentResolver().query(
            MediaStore.Images.Media.EXTERNAL_CONTENT_URI,
            columns,
            null,
            null,
            orderBy)) {
        if (cursor != null) {
            // 用while循环遍历所有图片数据
            while (cursor.moveToNext()) {
                // 你的后续逻辑写在这里
            }
        }
    } catch (Exception e) {
        e.printStackTrace();
    }
}

2. 检查列索引是否有效 #

如果cursor.getColumnIndex(MediaStore.Images.Media.DATA)返回-1，说明查询的列名无效（比如拼写错误），这时候调用getString(-1)会直接抛异常。

修复代码：先判断列索引是否合法，还要额外检查路径是否为空：

int dataColumnIndex = cursor.getColumnIndex(MediaStore.Images.Media.DATA);
// 先确认列索引有效
if (dataColumnIndex != -1) {
    String imagePath = cursor.getString(dataColumnIndex);
    // 避免路径为空导致File初始化异常
    if (imagePath != null) {
        imageFile = new File(imagePath);
        // 处理图片文件的逻辑
    }
}

3. 权限是否正确申请 #

Android 6.0（API 23）及以上版本，读取外部存储需要动态申请权限；Android 13+推荐使用更精细的READ_MEDIA_IMAGES权限，而不是旧的READ_EXTERNAL_STORAGE。

步骤1：在Manifest中声明权限 #

<!-- 兼容Android 12及以下 -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"
    android:maxSdkVersion="32" />
<!-- Android 13+ 专用权限 -->
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES"
    android:minSdkVersion="33" />

步骤2：动态申请权限 #

private static final int REQUEST_PERMISSION_CODE = 100;

public void checkPermissionAndGetImages(Context context) {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
        // Android 13+ 检查READ_MEDIA_IMAGES权限
        if (ContextCompat.checkSelfPermission(context, Manifest.permission.READ_MEDIA_IMAGES) != PackageManager.PERMISSION_GRANTED) {
            ActivityCompat.requestPermissions((Activity) context, new String[]{Manifest.permission.READ_MEDIA_IMAGES}, REQUEST_PERMISSION_CODE);
            return;
        }
    } else {
        // Android 12及以下检查READ_EXTERNAL_STORAGE权限
        if (ContextCompat.checkSelfPermission(context, Manifest.permission.READ_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED) {
            ActivityCompat.requestPermissions((Activity) context, new String[]{Manifest.permission.READ_EXTERNAL_STORAGE}, REQUEST_PERMISSION_CODE);
            return;
        }
    }
    // 权限已授予，执行获取图片逻辑
    getImages(context);
}

4. 适配Android 10+的Scoped Storage限制 #

从Android 10（API 29）开始，系统限制了直接访问文件路径，MediaStore.Images.Media.DATA列可能返回null或者无法直接访问的路径。这时候推荐通过Uri来读取图片，而不是直接用File路径。

替代方案（更兼容的写法）：

int idColumnIndex = cursor.getColumnIndex(MediaStore.Images.Media._ID);
long imageId = cursor.getLong(idColumnIndex);
// 通过ID生成图片的Uri
Uri imageUri = ContentUris.withAppendedId(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, imageId);
// 用ContentResolver打开输入流读取图片
try (InputStream is = context.getContentResolver().openInputStream(imageUri)) {
    Bitmap bitmap = BitmapFactory.decodeStream(is);
    // 处理Bitmap的逻辑
} catch (IOException e) {
    e.printStackTrace();
}

最后总结 #

空指针的核心原因通常是：

• Cursor没有有效数据就直接操作
• 列索引获取失败
• 权限未正确申请
• 忽略了Android版本的存储权限限制

把上面的检查点都覆盖到，应该就能解决问题啦！

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