Android端选择头像时出现SecurityException权限异常求助

看起来你遇到的线上崩溃问题，核心是Uri权限管理不当和错误的文件路径处理导致的——模拟器没问题是因为它的权限校验更宽松，而真实设备的权限机制执行得更严格。下面一步步拆解原因并给出修复方案：

问题根源拆解 #

1. Android 5.1.1的权限拒绝 #

你声明了MANAGE_DOCUMENTS权限，但这个是系统级权限，普通应用根本无法通过Manifest获取到。虽然你用了ACTION_OPEN_DOCUMENT，但没有主动保留Uri的访问权限，导致后续访问时权限被系统回收，直接触发SecurityException。

2. Android 8.0.0的权限拒绝 #

8.0+对文件访问权限做了收紧，ACTION_OPEN_DOCUMENT返回的Uri是基于内容提供者的临时权限入口，你尝试把它转成File对象直接访问——这不仅需要传统的读写存储权限，而且这种转换本身就是错误的：返回的Uri不是真实的文件路径，只是内容提供者的访问标识。

3. Uri转File的致命错误 #

你的getFileNameFromURI方法返回的是图片的文件名（比如avatar.jpg），不是完整的文件路径。用这个文件名创建File对象完全无效，这不仅会导致后续操作失败，还会触发不必要的权限检查。

修复方案 #

1. 持久化Uri访问权限 #

在onActivityResult中获取到Uri后，主动申请持久化权限，确保应用重启后也能访问该Uri：

@Override
public void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    if (requestCode == IMAGE_PICKER_REQUEST && resultCode == Activity.RESULT_OK) {
        if (data != null) {
            Uri imageUri = data.getData();
            // 针对KITKAT+版本获取持久化权限
            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
                int takeFlags = data.getFlags() & (Intent.FLAG_GRANT_READ_URI_PERMISSION | Intent.FLAG_GRANT_WRITE_URI_PERMISSION);
                getContentResolver().takePersistableUriPermission(imageUri, takeFlags);
            }
            // 只显示文件名，不要尝试转成File路径
            String fileName = getFileNameFromURI(imageUri);
            uploadProfilePicture.setText(fileName);
            userProfilePicUri = imageUri.toString();
        }
    }
}

2. 正确访问文件内容，放弃直接转File #

不要试图把ACTION_OPEN_DOCUMENT返回的Uri转成File，直接用ContentResolver访问内容即可。比如获取Bitmap：

// 正确获取头像Bitmap的方式
try (InputStream inputStream = getContentResolver().openInputStream(imageUri)) {
    Bitmap userPicBitmap = BitmapFactory.decodeStream(inputStream);
    // 在这里处理Bitmap（比如显示、上传等）
} catch (IOException e) {
    e.printStackTrace();
}

如果需要上传文件，直接读取InputStream的字节流进行上传，不要依赖文件路径。

3. 优化权限声明 #

移除无用的MANAGE_DOCUMENTS权限（普通应用拿不到），并对高版本系统做权限适配：

<!-- 仅在Android 9及以下声明读写存储权限 -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="28" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxSdkVersion="28" />
<!-- 移除这个无效权限 -->
<!-- <uses-permission android:name="android.permission.MANAGE_DOCUMENTS" /> -->

Android 10+使用内容提供者访问文件时，不需要传统的读写存储权限。

4. 优化Intent创建逻辑 #

调整头像选择的Intent创建，让低版本也能正确获取临时权限：

private void pickProfilePictureTask() {
    Intent intent;
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
        intent = new Intent(Intent.ACTION_OPEN_DOCUMENT);
        intent.setType("image/*");
        intent.addCategory(Intent.CATEGORY_OPENABLE);
    } else {
        intent = new Intent(Intent.ACTION_GET_CONTENT);
        intent.setType("image/*");
    }
    startActivityForResult(intent, IMAGE_PICKER_REQUEST);
}

额外注意事项 #

• 不要存储Uri的字符串后直接在后续流程中使用，最好直接保留Uri对象，或者每次通过ContentResolver访问时验证权限。
• 上传文件时，优先使用InputStream读取内容，避免依赖文件路径，这样能适配所有Android版本的权限机制。

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