Android中用Java从URL下载图片到本地存储失败，求解决方案

一、权限相关说明 #

• 无需额外添加WiFi相关权限，INTERNET权限已允许应用通过任意网络（WiFi/移动数据）访问网络资源。
• 注意Android版本适配差异：
  • Android 9及以下：WRITE_EXTERNAL_STORAGE和READ_EXTERNAL_STORAGE可正常访问公共存储。
  • Android 10+：启用分区存储（Scoped Storage），WRITE_EXTERNAL_STORAGE不再授予公共存储写入权限，若要保存到公共下载目录，需使用MediaStore或调整DownloadManager的目标路径配置。

二、现有代码的问题 #

1. 权限请求逻辑错误：
   • 条件判断用&&会导致仅当两个权限均未授权时才触发请求，应改为||。
   • 连续两次调用requestPermissions会覆盖请求，需一次性提交多个权限申请。
2. DownloadManager路径问题：
   • setDestinationInExternalFilesDir将文件保存至应用私有外部存储（/Android/data/包名/files/Downloads），该目录无需存储权限，但用户在系统文件管理器中不易找到；若需保存到公共下载目录，需改用setDestinationInPublicDir。
3. Firebase Storage URL有效性：
   • 确认URL是否为持久化公开链接，临时签名URL可能因过期导致下载失败。

三、修正后的DownloadManager实现 #

1. 修正权限请求逻辑 #

binding.downloadBtn.setOnClickListener(new View.OnClickListener() {
    @Override
    public void onClick(View view) {
        boolean hasPermission = false;
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
            // Android 10+ 保存到公共目录无需WRITE权限
            hasPermission = true;
        } else {
            hasPermission = ContextCompat.checkSelfPermission(ShowImageActivity.this, Manifest.permission.WRITE_EXTERNAL_STORAGE) == PackageManager.PERMISSION_GRANTED;
        }

        if (!hasPermission) {
            ActivityCompat.requestPermissions(ShowImageActivity.this,
                    new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE},
                    123);
            Toast.makeText(ShowImageActivity.this, "需要存储权限以下载图片", Toast.LENGTH_SHORT).show();
        } else {
            Toast.makeText(ShowImageActivity.this, "正在下载图片...", Toast.LENGTH_SHORT).show();
            downloadImageToPublicDir(ShowImageActivity.this, "image", ".jpg", imageURL);
        }
    }
});

2. 保存到公共下载目录的DownloadManager配置 #

public void downloadImageToPublicDir(Context context, String fileName, String fileExtension, String url) {
    DownloadManager dm = (DownloadManager) context.getSystemService(Context.DOWNLOAD_SERVICE);
    Uri uri = Uri.parse(url);
    DownloadManager.Request request = new DownloadManager.Request(uri);

    // 设置通知显示逻辑
    request.setNotificationVisibility(DownloadManager.Request.VISIBILITY_VISIBLE_NOTIFY_COMPLETED);
    // 保存到系统公共下载目录
    request.setDestinationInPublicDir(Environment.DIRECTORY_DOWNLOADS, fileName + fileExtension);
    // 指定文件类型
    request.setMimeType("image/jpeg");
    // 设置下载通知的标题与描述
    request.setTitle("聊天图片下载");
    request.setDescription("正在保存图片到下载文件夹");

    dm.enqueue(request);
}

四、Firebase Storage原生下载方法（更稳定） #

直接使用Firebase官方API下载，无需处理URL有效性问题：

1. 确认依赖配置 #

在build.gradle中确保添加Firebase Storage依赖：

implementation 'com.google.firebase:firebase-storage:20.0.1' // 请使用最新版本号

2. 实现下载逻辑 #

// 替换为你的Firebase Storage图片路径
StorageReference storageRef = FirebaseStorage.getInstance().getReference().child("chat/images/xxx.jpg");

// 创建本地文件（示例保存到应用私有下载目录）
File localFile = null;
try {
    localFile = File.createTempFile("chat_image", ".jpg", getExternalFilesDir(Environment.DIRECTORY_DOWNLOADS));
} catch (IOException e) {
    e.printStackTrace();
    Toast.makeText(this, "创建本地文件失败", Toast.LENGTH_SHORT).show();
    return;
}

// 启动下载任务
storageRef.getFile(localFile).addOnSuccessListener(taskSnapshot -> {
    Toast.makeText(this, "图片已保存至: " + localFile.getAbsolutePath(), Toast.LENGTH_LONG).show();
}).addOnFailureListener(exception -> {
    Toast.makeText(this, "下载失败: " + exception.getMessage(), Toast.LENGTH_SHORT).show();
});

五、手动下载实现（URLConnection） #

如果不想依赖DownloadManager或Firebase API，可使用原生URLConnection实现：

private void downloadImageManually(String url, String savePath) {
    new Thread(() -> {
        try {
            URL imageUrl = new URL(url);
            HttpURLConnection conn = (HttpURLConnection) imageUrl.openConnection();
            conn.setDoInput(true);
            conn.connect();
            
            InputStream input = conn.getInputStream();
            FileOutputStream output = new FileOutputStream(savePath);

            byte[] buffer = new byte[1024];
            int bytesRead;
            while ((bytesRead = input.read(buffer)) != -1) {
                output.write(buffer, 0, bytesRead);
            }

            output.close();
            input.close();
            
            // 主线程更新UI
            runOnUiThread(() -> Toast.makeText(ShowImageActivity.this, "下载完成", Toast.LENGTH_SHORT).show());
        } catch (IOException e) {
            e.printStackTrace();
            runOnUiThread(() -> Toast.makeText(ShowImageActivity.this, "下载失败: " + e.getMessage(), Toast.LENGTH_SHORT).show());
        }
    }).start();
}

调用示例：

// 保存到应用私有下载目录
String savePath = getExternalFilesDir(Environment.DIRECTORY_DOWNLOADS) + "/chat_image.jpg";
downloadImageManually(imageURL, savePath);

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