如何在 Android（Java）中正确下载文件（适配 Android 11+）

浅敏君_5920

发布时间：2026-10-16 11:44:02

720人浏览过

来源于php中文网

原创

如何在 android（java）中正确下载文件（适配 android 11+）

本文详解在 Android（尤其是 API 30+）中使用 Java 安全、可靠地下载网络文件的完整方案，涵盖 DownloadManager 失效原因、手动流式下载的正确实现、存储路径适配、权限处理及现代替代建议。

本文详解在 Android（尤其是 API 30+）中使用 Java 安全、可靠地下载网络文件的完整方案，涵盖 DownloadManager 失效原因、手动流式下载的正确实现、存储路径适配、权限处理及现代替代建议。

在 Android 11（API 30）及以上版本中，直接使用 DownloadManager 或旧式 File I/O 下载文件常遇到“无声失败”——无报错、无通知、文件不落地。根本原因在于：分区存储（Scoped Storage）强制启用 + 过时的存储路径 + 缺失运行时权限与配置。以下提供经过验证的可运行解决方案。

✅ 正确做法：使用 `MediaStore` 写入公共媒体目录（推荐，Android 10+）

Environment.getExternalStoragePublicDirectory() 已被弃用（API 29+），且在 Android 11+ 上即使声明权限也无法访问。正确方式是通过 MediaStore.Images.Media.EXTERNAL_CONTENT_URI 插入新条目，获取输出流：

private void downloadWithMediaStore(String title, String url) {
    // 1. 构建媒体插入参数
    ContentValues values = new ContentValues();
    values.put(MediaStore.Images.Media.DISPLAY_NAME, title);
    values.put(MediaStore.Images.Media.MIME_TYPE, "image/jpeg");
    values.put(MediaStore.Images.Media.RELATIVE_PATH, Environment.DIRECTORY_PICTURES + "/MyApp");

    // 2. 获取输出流（自动处理路径与权限）
    Uri uri;
    try (ContentResolver resolver = getContentResolver()) {
        uri = resolver.insert(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, values);
        if (uri == null) throw new IOException("Failed to create media entry");

        try (InputStream is = new URL(url).openStream();
             OutputStream os = resolver.openOutputStream(uri)) {

            byte[] buffer = new byte[8192];
            int len;
            while ((len = is.read(buffer)) != -1) {
                os.write(buffer, 0, len);
            }
        }
        Toast.makeText(this, "Download completed: " + title, Toast.LENGTH_SHORT).show();
    } catch (Exception e) {
        Log.e("Download", "Failed", e);
        Toast.makeText(this, "Download failed: " + e.getMessage(), Toast.LENGTH_LONG).show();
    }
}

✅ 优势：无需 WRITE_EXTERNAL_STORAGE 权限；文件自动出现在系统图库；兼容 Android 10–14；支持通知与状态监听（可扩展）。

立即学习“Java免费学习笔记（深入）”；

OpenJDK 24

下载

⚠️ 若坚持使用 `DownloadManager`：关键修复点

你原代码失败的核心问题有三：

❌ setDestinationUri() 指向私有目录（getExternalFilesDir()），DownloadManager 拒绝写入应用私有路径；
❌ 缺少 android.permission.POST_NOTIFICATIONS（Android 12+ 必需）；
❌ Android 11+ 需显式声明 android:requestLegacyExternalStorage="false"（默认已生效），且目标路径必须为公共目录或 Content URI。

修正后的 DownloadManager 调用（仅适用于 Android 10 及以下，或需降级兼容）：

private void downloadWithManager(String url, String fileName) {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
        // Android 11+ 不推荐，改用 MediaStore
        downloadWithMediaStore(fileName, url);
        return;
    }

    DownloadManager manager = (DownloadManager) getSystemService(Context.DOWNLOAD_SERVICE);
    Uri uri = Uri.parse(url);

    DownloadManager.Request request = new DownloadManager.Request(uri)
            .setTitle("NASA APOD Image")
            .setDescription("Downloading...")
            .setNotificationVisibility(DownloadManager.Request.VISIBILITY_VISIBLE_NOTIFY_COMPLETED)
            .setDestinationInExternalPublicDir(Environment.DIRECTORY_PICTURES, fileName)
            .setAllowedOverMetered(true)
            .setAllowedOverRoaming(true);

    manager.enqueue(request);
}

⚠️ 注意：setDestinationInExternalPublicDir() 在 Android 11+ 仍可用，但需确保 Manifest 中已声明：

<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
<!-- Android 11+ 无需 WRITE_EXTERNAL_STORAGE -->

? 权限与清单配置（Android 11+ 必须）

<!-- AndroidManifest.xml -->
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
<!-- Android 10+ 不再需要 READ/WRITE_EXTERNAL_STORAGE -->