Android 11下使用FileProvider分享SD卡PDF文件报权限拒绝问题求助

问题根因 #

你遇到的权限异常由Android 11特性适配、逻辑顺序错误、权限范围不匹配三类问题共同导致：

• Android 11引入了应用包可见性机制，未配置对应权限的情况下queryIntentActivities()无法返回完整的匹配应用列表，手动授权逻辑没有覆盖到实际打开PDF的目标应用
• 权限授予顺序错误，未先完成所有目标应用授权就设置Intent启动参数
• 部分PDF应用打开文件时会默认请求写入权限，仅授予读权限会触发拦截
• 若项目已迁移到AndroidX，仍使用support库的FileProvider会出现兼容性问题
• 硬编码的authorities参数容易和清单文件的动态配置不匹配，触发授权校验失败

修复步骤 #

第一步：添加Android 11包可见性配置 #

在AndroidManifest.xml根节点下添加如下配置，保证可以查询到所有支持打开PDF的应用：

<!-- 方式一：通用查询权限，Android 13及以上不需要 -->
<uses-permission android:name="android.permission.QUERY_ALL_PACKAGES"
    android:maxSdkVersion="33" />

<!-- 方式二：仅查询PDF类应用，不需要申请权限，二选一即可 -->
<queries>
    <intent>
        <action android:name="android.intent.action.VIEW" />
        <data android:mimeType="application/pdf" />
    </intent>
</queries>

第二步：修正FileProvider配置 #

如果项目已迁移到AndroidX，将清单文件中Provider的类替换为AndroidX版本，同时保持authorities用动态变量配置：

<provider
    android:name="androidx.core.content.FileProvider"
    android:authorities="${applicationId}.provider"
    android:exported="false"
    android:grantUriPermissions="true">
    <meta-data
        android:name="android.support.FILE_PROVIDER_PATHS"
        android:resource="@xml/file_paths" />
</provider>

第三步：调整打开PDF的逻辑顺序 #

File file = new File(pdfpath);
// authorities参数用BuildConfig动态拼接，避免硬编码和实际包名不匹配
Uri uri = FileProvider.getUriForFile(this, BuildConfig.APPLICATION_ID + ".provider", file);
Intent intent = new Intent(Intent.ACTION_VIEW);
intent.setDataAndType(uri, "application/pdf");

// 先给所有匹配应用授予读写权限
List<ResolveInfo> resInfoList = getPackageManager().queryIntentActivities(intent, PackageManager.MATCH_DEFAULT_ONLY);
for (ResolveInfo resolveInfo : resInfoList) {
    String packageName = resolveInfo.activityInfo.packageName;
    grantUriPermission(packageName, uri, Intent.FLAG_GRANT_READ_URI_PERMISSION | Intent.FLAG_GRANT_WRITE_URI_PERMISSION);
}

// 再给Intent设置权限标记和启动参数
intent.setFlags(Intent.FLAG_ACTIVITY_NO_HISTORY | Intent.FLAG_GRANT_READ_URI_PERMISSION | Intent.FLAG_GRANT_WRITE_URI_PERMISSION);

try {
    startActivity(intent);
} catch (ActivityNotFoundException e) {
    Toast.makeText(MainActivity.this, "No Application Available to View PDF", Toast.LENGTH_SHORT).show();
}

第四步：优化file_paths配置 #

替换权限过大的root-path配置，专门适配SD卡应用专属目录的访问，稳定性更高：

<?xml version="1.0" encoding="utf-8"?>
<paths xmlns:android="http://schemas.android.com/apk/res/android">
    <!-- 匹配内部存储应用专属目录 -->
    <external-path name="external_files" path="."/>
    <!-- 匹配SD卡应用专属目录 -->
    <external-files-path name="sdcard_app_files" path="."/>
</paths>

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