从Gmail附件打开数据意图时遭遇java.lang.SecurityException权限问题求助

错误分析 #

你遇到的java.lang.SecurityException是因为访问Gmail的SapiUiProvider时缺少权限。该Provider未导出，因此你的应用必须通过临时Uri权限或持久化Uri权限才能访问其内容，错误发生在调用getContentResolver().query()读取Uri的代码行。

解决方案 #

1. 启动文件选择Intent时添加权限Flag #

如果你是通过Intent.ACTION_GET_CONTENT/ACTION_OPEN_DOCUMENT等方式从Gmail获取Uri，启动Intent时必须添加FLAG_GRANT_READ_URI_PERMISSION，确保系统授予临时读取权限：

Intent pickIntent = new Intent(Intent.ACTION_OPEN_DOCUMENT);
pickIntent.addCategory(Intent.CATEGORY_OPENABLE);
pickIntent.setType("application/xml"); // 匹配你的GPX文件类型
// 添加读取权限Flag
pickIntent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION);
// 启动选择器（如果需要）
Intent chooser = Intent.createChooser(pickIntent, "选择GPX文件");
startActivityForResult(chooser, REQUEST_PICK_FILE);

如果使用AndroidX的registerForActivityResult，回调中获取的Uri会自动携带临时权限，但仍需确保启动Intent时添加了上述Flag。

2. 配置Activity允许接收Uri权限 #

在Manifest的目标Activity标签中添加android:grantUriPermissions="true"，允许其他应用（如Gmail）向你的应用授予Uri访问权限：

<activity
    android:name=".YourFileHandlingActivity"
    android:grantUriPermissions="true">
    <!-- 你的intent-filter配置 -->
    <intent-filter>
        <action android:name="android.intent.action.VIEW"/>
        <action android:name="android.intent.action.GET_CONTENT"/>
        <action android:name="android.intent.action.OPEN_DOCUMENT"/>
        <action android:name="android.intent.action.PICK"/>
        <category android:name="android.intent.category.OPENABLE"/>
        <category android:name="android.intent.category.DEFAULT"/>
        <category android:name="android.intent.category.BROWSABLE"/>
        <data android:scheme="content"/>
        <data android:pathPattern=".*\.gpx"/>
        <data android:mimeType="application/xml"/>
        <data android:mimeType="application/octet-stream"/>
    </intent-filter>
</activity>

3. 申请持久化Uri权限（可选） #

如果需要在应用重启后仍能访问该文件，且使用的是ACTION_OPEN_DOCUMENT，可调用takePersistableUriPermission获取持久化权限：

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    if (requestCode == REQUEST_PICK_FILE && resultCode == RESULT_OK) {
        Uri uri = data.getData();
        if (uri != null && Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
            // 申请持久化读取权限
            getContentResolver().takePersistableUriPermission(
                uri,
                Intent.FLAG_GRANT_READ_URI_PERMISSION
            );
            // 后续即可安全使用该Uri查询
            Cursor fileCursor = getContentResolver().query(
                uri,
                new String[]{OpenableColumns.DISPLAY_NAME},
                null, null, null
            );
            // 处理Cursor...
        }
    }
}

4. 避免持久化未授权的Uri #

不要将临时权限的Uri保存到数据库或SharedPreferences中，因为应用重启后权限会失效。如需持久化访问，必须使用步骤3的方式获取持久化权限。

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