Android 11+下如何让FileProvider适配外部存储？

核心错误原因 #

Logcat提示的Failed to find provider info for com.hmdm.fileprovidertest.provider是关键问题，说明FileProvider的注册配置存在不匹配或遗漏；而Android 11+的分区存储机制，也会影响外部根目录文件的访问权限。

分步排查与修复 #

1. 检查FileProvider的Manifest注册

确保AndroidManifest.xml中的Provider配置完全正确，这是解决"找不到provider"的核心：

<application
    ...>

    <!-- FileProvider必须注册在<application>标签内部 -->
    <provider
        android:name="androidx.core.content.FileProvider" <!-- 必须使用AndroidX版本，Android11+不建议用旧support库 -->
        android:authorities="com.hmdm.fileprovidertest.provider" <!-- 必须和代码中调用的authority完全一致 -->
        android:exported="false" <!-- 固定为false，FileProvider不允许导出 -->
        android:grantUriPermissions="true"> <!-- 必须开启权限授予 -->
        <meta-data
            android:name="android.support.FILE_PROVIDER_PATHS"
            android:resource="@xml/provider_paths" /> <!-- 指向路径配置文件 -->
    </provider>

</application>

2. 修正provider_paths.xml路径配置

Android 11+下，要访问外部存储根目录，需在res/xml/provider_paths.xml中明确配置外部根路径：

<?xml version="1.0" encoding="utf-8"?>
<paths xmlns:android="http://schemas.android.com/apk/res/android">
    <!-- 匹配外部存储根目录（对应Environment.getExternalStorageDirectory()） -->
    <external-path name="external_root" path="." />
    <!-- 可选：如果需要访问应用私有外部目录，添加此行 -->
    <external-files-path name="app_external_files" path="." />
</paths>

注意：name字段是自定义的别名，path="."表示匹配该目录下的所有文件和子目录。

3. 适配Android 11+的分区存储权限

如果访问的是外部根目录的非媒体类文件，Android 11+需要申请MANAGE_EXTERNAL_STORAGE权限：

• 在Manifest中添加权限声明：

<uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE" />

• 在代码中引导用户手动授权：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
    if (!Environment.isExternalStorageManager()) {
        Intent permissionIntent = new Intent(Settings.ACTION_MANAGE_APP_ALL_FILES_ACCESS_PERMISSION);
        Uri uri = Uri.fromParts("package", getPackageName(), null);
        permissionIntent.setData(uri);
        startActivity(permissionIntent);
    }
}

4. 修正文件打开逻辑

确保调用FileProvider时传递正确的参数，并添加权限标记：

private void openExternalImage(File targetFile) {
    if (!targetFile.exists()) {
        Toast.makeText(this, "目标文件不存在", Toast.LENGTH_SHORT).show();
        return;
    }

    // 生成FileProvider的Uri，authority必须和Manifest一致
    Uri fileUri = FileProvider.getUriForFile(
            this,
            "com.hmdm.fileprovidertest.provider",
            targetFile
    );

    Intent viewIntent = new Intent(Intent.ACTION_VIEW);
    viewIntent.setDataAndType(fileUri, "image/*");
    viewIntent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION); // 必须添加，授予临时读取权限

    // 检查是否有应用可处理该Intent
    if (viewIntent.resolveActivity(getPackageManager()) != null) {
        startActivity(viewIntent);
    } else {
        Toast.makeText(this, "未找到可用的图片查看应用", Toast.LENGTH_SHORT).show();
    }
}

常见坑点总结 #

• Authority不匹配：代码中调用的authority必须和Manifest中android:authorities完全一致，大小写、包名都不能错。
• AndroidX依赖：Android 11+项目必须确保依赖AndroidX库，避免使用旧的android.support.v4.content.FileProvider。
• 权限标记遗漏：Intent.FLAG_GRANT_READ_URI_PERMISSION必须添加，否则目标应用无法获取文件访问权限。

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