Android使用Image Picker获取图片完整路径时空指针异常

开发Android应用时，从系统图库选择图片后计划使用iText库将图片转换为PDF文件，实际运行选择图片后应用直接崩溃，抛出空指针异常。排查发现执行String picturePath = cursor.getString(columnIndex);代码时获取到的图片路径为null。

问题复现代码 #

final private int SELECT_PICTURE = 201;

select_img.setOnClickListener(new View.OnClickListener() {
    @Override
    public void onClick(View v) {
        Intent intent = new Intent();
        intent.setType("image/*");
        intent.setAction(Intent.ACTION_GET_CONTENT);
        startActivityForResult(Intent.createChooser(intent,"Select Picture"), SELECT_PICTURE);
    }
});

protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    if (resultCode == RESULT_OK) {
        switch(requestCode){
            case SELECT_PICTURE:
                Uri selectedImageUri = data.getData();
                String[] filePathColumn = { MediaStore.Images.Media.DATA };
                Cursor cursor = getContentResolver().query(selectedImageUri,filePathColumn, null, null, null);
                cursor.moveToFirst();
                int columnIndex = cursor.getColumnIndex(filePathColumn[0]);
                String picturePath = cursor.getString(columnIndex);
                cursor.close();
                Bitmap bmp = BitmapFactory.decodeFile(picturePath);
                ByteArrayOutputStream stream = new ByteArrayOutputStream();
                bmp.compress(Bitmap.CompressFormat.PNG, 100, stream);
                // 后续iText转PDF逻辑
        }
    }
}

崩溃日志 #

java.lang.RuntimeException: Failure delivering result ResultInfo{who=null, request=201, result=-1, data=Intent { dat=content://com.android.providers.media.documents/document/image:87703 flg=0x1 }} to activity {com.example.pdfcreator/com.example.pdfcreator.MainActivity}: java.lang.NullPointerException: Attempt to invoke virtual method 'boolean android.graphics.Bitmap.compress(android.graphics.Bitmap$CompressFormat, int, java.io.OutputStream)' on a null object reference
    at android.app.ActivityThread.deliverResults(ActivityThread.java:4423)
    at android.app.ActivityThread.handleSendResult(ActivityThread.java:4465)
    at android.app.servertransaction.ActivityResultItem.execute(ActivityResultItem.java:49)
    at android.app.servertransaction.TransactionExecutor.executeCallbacks(TransactionExecutor.java:108)
    at android.app.servertransaction.TransactionExecutor.execute(TransactionExecutor.java:68)
    at android.app.ActivityThread$H.handleMessage(ActivityThread.java:1831)
    at android.os.Handler.dispatchMessage(Handler.java:106)
    at android.os.Looper.loop(Looper.java:201)
    at android.app.ActivityThread.main(ActivityThread.java:6810)
    at java.lang.reflect.Method.invoke(Native Method)
    at com.android.internal.os.RuntimeInit$MethodAndArgsCaller.run(RuntimeInit.java:547)
    at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:873)
Caused by: java.lang.NullPointerException: Attempt to invoke virtual method 'boolean android.graphics.Bitmap.compress(android.graphics.Bitmap$CompressFormat, int, java.io.OutputStream)' on a null object reference
    at com.example.pdfcreator.MainActivity.onActivityResult(MainActivity.java:159)
    at android.app.Activity.dispatchActivityResult(Activity.java:7590)
    at android.app.ActivityThread.deliverResults(ActivityThread.java:441)

• Android 4.4（API 19）之后，ACTION_GET_CONTENT返回的是DocumentProvider类型的Uri，格式为content://com.android.providers.media.documents/...，直接查询MediaStore.Images.Media.DATA列本身就不保证能拿到值，绝大多数场景返回null。
• 原代码完全没有做容错：既没判断返回的cursor是否为null，也没判断查询到的columnIndex是否有效，更没判断picturePath是否为空。路径为null时BitmapFactory.decodeFile()直接返回null，后续调用bmp.compress()就会触发空指针崩溃。
• Android 10（API 29）起系统强制分区存储，就算通过特殊手段拿到了媒体文件的真实物理路径，应用也没有权限直接通过文件接口访问，照样会读文件失败。

不要强行获取文件真实路径，直接通过ContentResolver读取Uri对应的输入流即可，该方案兼容所有Android版本，不需要额外申请存储权限。

基础修正代码 #

protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    if (resultCode == RESULT_OK && data != null) {
        switch(requestCode){
            case SELECT_PICTURE:
                Uri selectedImageUri = data.getData();
                if (selectedImageUri == null) return;
                Bitmap bmp = null;
                try {
                    // 直接通过内容解析器打开输入流解码Bitmap，不需要文件路径
                    InputStream inputStream = getContentResolver().openInputStream(selectedImageUri);
                    bmp = BitmapFactory.decodeStream(inputStream);
                    if (inputStream != null) inputStream.close();
                } catch (Exception e) {
                    e.printStackTrace();
                }
                if (bmp == null) return;
                ByteArrayOutputStream stream = new ByteArrayOutputStream();
                bmp.compress(Bitmap.CompressFormat.PNG, 100, stream);
                // 后续将stream中的字节传入iText生成PDF即可
                bmp.recycle(); // 用完及时回收Bitmap避免内存泄漏
                break;
        }
    }
}

适配iText的最优实现 #

如果最终目的是把图片传入iText生成PDF，完全不需要解码成Bitmap再转字节流，直接用Uri打开的输入流创建iText的Image对象即可，省去Bitmap编解码开销，也不会出现大图片OOM问题：

try (InputStream inputStream = getContentResolver().openInputStream(selectedImageUri)) {
    if (inputStream == null) return;
    // iText 5版本写法，iText7可根据对应API调整入参
    Image pdfImg = Image.getInstance(IOUtils.toByteArray(inputStream));
    // 把pdfImg加入PDF文档即可
} catch (Exception e) {
    e.printStackTrace();
}

额外注意事项 #

• 不要使用网上流传的各种"根据Uri获取真实路径"的工具类，这类工具类在不同厂商ROM、不同Android版本上兼容性极差，会出现大量适配问题，官方推荐的方式就是通过ContentResolver基于Uri操作媒体资源。
• 废弃startActivityForResult，改用新的Activity Result API实现图片选择，适配新版Android平台要求。

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