Android模拟器中DownloadManager无法工作的问题求助

问题点分析 #

1. 变量误用错误
   主代码中File fileFolder = new File(path);的path未定义，应为apkPath；后续file.mkdirs();中的file是未声明的变量，实际应该操作fileFolder对象。

2. 空路径风险
   getDiskCacheDir方法中，若context.getExternalFilesDir(null)返回null，会直接返回初始值为null的cachePath，导致getApkPath拼接出无效的null路径，后续文件创建和下载都会失败。

3. Scoped Storage适配问题
   Android 10（API 29）及以上系统启用Scoped Storage，使用Uri.fromFile(file)设置下载目标会抛出FileUriExposedException，且DownloadManager对文件路径的处理逻辑有变更。

4. 目录创建逻辑缺陷
   getDiskCacheDir中创建外部文件目录时使用mkdir()，若父目录不存在会创建失败，应使用mkdirs()确保多级目录都能创建。

5. 权限缺失

   • 必须在AndroidManifest.xml中声明INTERNET权限，否则无法发起网络下载请求。
   • Android 6.0（API 23）至Android 9（API 28）需动态申请WRITE_EXTERNAL_STORAGE权限（若使用外部存储路径）。

修复后的代码实现 #

主下载逻辑代码

String apkPath = getApkPath(context);
// 修正变量名错误，使用apkPath而非未定义的path
File fileFolder = new File(apkPath);
if (!fileFolder.exists()) {
    // 修正变量，操作fileFolder而非未声明的file
    fileFolder.mkdirs();
}
String apkFilePath = apkPath + "test.apk";
File file = new File(apkFilePath);

DownloadManager downloadManager = (DownloadManager) context.getSystemService(Context.DOWNLOAD_SERVICE);

DownloadManager.Request request = new DownloadManager.Request(Uri.parse(downloadUrl))
        .setNotificationVisibility(DownloadManager.Request.VISIBILITY_VISIBLE)
        .setVisibleInDownloadsUi(true)
        .setMimeType("application/vnd.android.package-archive");

// 适配Android 10+的Scoped Storage
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
    // 使用DownloadManager内置的路径设置方法，避免FileUriExposedException
    request.setDestinationInExternalFilesDir(context, "/CheckManager/apk", "test.apk");
} else {
    request.setDestinationUri(Uri.fromFile(file));
}

// 发起下载请求
long downloadId = downloadManager.enqueue(request);

修正后的getDiskCacheDir方法

public String getDiskCacheDir(Context context) {
    String cachePath = null;
    if (Environment.MEDIA_MOUNTED.equals(Environment.getExternalStorageState())
            || !Environment.isExternalStorageRemovable()) {
        File file = context.getExternalFilesDir(null);
        if (file != null) {
            // 使用mkdirs()确保多级目录创建成功
            if (!file.exists()) {
                file.mkdirs();
            }
            cachePath = file.getPath();
        } else {
            // 外部存储不可用时， fallback到内部存储
            cachePath = context.getFilesDir().getPath();
        }
    } else {
        cachePath = context.getFilesDir().getPath();
    }
    return cachePath;
}

权限配置

1. 在AndroidManifest.xml中添加权限：

<uses-permission android:name="android.permission.INTERNET" />
<!-- Android 9及以下需要 -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="28" />

2. Android 6.0+动态申请权限（若目标SDK<=28）：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M && ContextCompat.checkSelfPermission(context, Manifest.permission.WRITE_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED) {
    ActivityCompat.requestPermissions((Activity) context, new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE}, 1001);
}

额外检查点 #

• 确保downloadUrl是有效的可访问URL，且服务器支持断点续传（可选，但能提升下载稳定性）。
• 可以通过DownloadManager.Query查询下载状态，排查具体失败原因：

DownloadManager.Query query = new DownloadManager.Query().setFilterById(downloadId);
Cursor cursor = downloadManager.query(query);
if (cursor.moveToFirst()) {
    int status = cursor.getInt(cursor.getColumnIndex(DownloadManager.COLUMN_STATUS));
    if (status == DownloadManager.STATUS_FAILED) {
        int reason = cursor.getInt(cursor.getColumnIndex(DownloadManager.COLUMN_REASON));
        // 根据reason值排查具体失败原因，如网络错误、存储路径无效等
    }
}
cursor.close();

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