Android使用FileProvider打开DownloadManager下载文件遇根目录配置错误

看起来你踩了FileProvider路径配置的典型坑——你的FileProvider授权的根目录和DownloadManager下载文件的实际存储位置不匹配，导致系统找不到对应的配置项抛出异常。我来一步步帮你解决：

问题根源 #

你的provider_paths.xml里用的是<external-files-path>，这个标签指向的是App的外部私有存储目录（路径大概是/storage/emulated/0/Android/data/你的包名/files/），但从错误日志看，你的下载文件存在公共外部存储的/storage/emulated/0/Classroom/...目录下，这个路径不在当前FileProvider的授权范围内，所以才会报错。

解决步骤 #

1. 调整FileProvider的路径配置 #

更新res/xml/provider_paths.xml，添加<external-path>标签来授权访问公共外部存储（或者更精确地授权你的下载目录）：

<?xml version="1.0" encoding="utf-8"?>
<paths xmlns:android="http://schemas.android.com/apk/res/android">
    <!-- 保留原有配置（如果其他功能需要用到） -->
    <external-files-path name="external_files" path="/"/>
    <!-- 添加这一行，授权访问公共外部存储根目录 -->
    <external-path name="external_storage" path="/"/>
    <!-- 更安全的做法：只授权你的应用专属下载目录，比如Classroom文件夹：
    <external-path name="classroom_downloads" path="Classroom/"/>
    -->
</paths>

提示：<external-path>对应系统的Environment.getExternalStorageDirectory()路径，也就是公共外部存储的根目录。如果想最小化权限范围，推荐只授权到你的应用实际使用的子目录。

2. 修正代码中的两处错误 #

你的代码里还有两个小问题需要修复：

• 变量名错误：最后调用startActivity(install)，但你创建的Intent对象是open，会导致运行错误
• 硬编码列名：直接用"local_uri"不如用系统常量可靠

修改后的核心代码：

try {
    DownloadManager dm = (DownloadManager) getSystemService(DOWNLOAD_SERVICE);
    long downloadId = intent.getLongExtra(DownloadManager.EXTRA_DOWNLOAD_ID, 0);
    DownloadManager.Query query = new DownloadManager.Query();
    query.setFilterById(downloadId);
    Cursor c = dm != null ? dm.query(query) : null;
    Log.d("Cursor", String.valueOf(c));
    String uri = null;
    if (c != null && c.moveToFirst()) {
        // 使用系统常量获取列名，避免硬编码
        int uriColumnIndex = c.getColumnIndex(DownloadManager.COLUMN_LOCAL_URI);
        uri = c.getString(uriColumnIndex);
    }
    Log.d("URI", uri);
    
    // 空值判断，避免后续崩溃
    if (uri == null) {
        Log.e("DownloadError", "无法获取下载文件的URI");
        return;
    }
    
    Intent open = new Intent(Intent.ACTION_VIEW);
    open.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION | Intent.FLAG_GRANT_WRITE_URI_PERMISSION);
    
    // 获取MIME类型（转小写避免匹配失败）
    String mimeType = "*/*";
    String extension = MimeTypeMap.getFileExtensionFromUrl(uri);
    if (extension != null) {
        mimeType = MimeTypeMap.getSingleton().getMimeTypeFromExtension(extension.toLowerCase());
    }
    
    // 转换为File并获取FileProvider URI
    File file = new File(Uri.parse(uri).getPath());
    Uri contentUri = FileProvider.getUriForFile(
        getApplicationContext(), 
        getPackageName() + ".provider", 
        file
    );
    
    open.setDataAndType(contentUri, mimeType);
    // 修正变量名错误
    startActivity(open);
    
} catch (Exception e) {
    e.printStackTrace();
}

额外注意事项 #

• 针对Android 10及以下版本，确保你的应用已经申请了WRITE_EXTERNAL_STORAGE权限；Android 11+下载到公共目录通常不需要额外权限，但如果是自定义目录可能需要适配分区存储。
• 如果你的DownloadManager是手动指定下载路径的，要确保该路径在FileProvider配置的根目录范围内。

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