Android Studio中DownloadManager下载文件后自动删除问题求助

问题原因分析 #

• 存储路径参数错误：setDestinationInExternalFilesDir的第二个参数应使用系统提供的目录常量（如Environment.DIRECTORY_DOWNLOADS），你传入的"/Download/"会导致路径拼接异常，系统无法正确识别持久化存储位置，最终误清理下载文件。
• 未验证下载状态：当前代码仅在广播回调中注销接收器，未检查下载是否成功。若下载过程中出现错误（如网络中断、文件校验失败），DownloadManager会自动删除未完成的临时文件，造成“下载完成后被删除”的错觉。
• Android 11+ 存储限制：若应用目标SDK为30及以上，即使使用应用私有外部存储，路径配置不当也可能触发系统文件清理机制。

解决建议 #

1. 修正存储路径参数 #

替换自定义路径为系统标准目录常量，确保路径正确生成：

// 替换原setDestinationInExternalFilesDir调用
request.setDestinationInExternalFilesDir(PDFActivity.this, 
    Environment.DIRECTORY_DOWNLOADS, "file.pdf");

注：Environment.DIRECTORY_DOWNLOADS无需手动添加斜杠，方法内部会自动处理路径拼接。

2. 在广播回调中验证下载结果 #

增加下载状态检查，确认文件是否成功保存，同时避免逻辑漏洞：

BroadcastReceiver onDownloadComplete = new BroadcastReceiver() {
    @Override
    public void onReceive(Context ctxt, Intent intent) {
        long downloadId = intent.getLongExtra(DownloadManager.EXTRA_DOWNLOAD_ID, -1);
        if (downloadId == -1) {
            return;
        }
        
        // 查询下载状态
        DownloadManager.Query query = new DownloadManager.Query();
        query.setFilterById(downloadId);
        Cursor cursor = downloadmanager.query(query);
        
        if (cursor.moveToFirst()) {
            int status = cursor.getInt(cursor.getColumnIndex(DownloadManager.COLUMN_STATUS));
            if (status == DownloadManager.STATUS_SUCCESSFUL) {
                // 下载成功，获取文件路径
                String filePath = cursor.getString(cursor.getColumnIndex(DownloadManager.COLUMN_LOCAL_URI));
                Log.d("Download", "文件保存路径: " + filePath);
            } else if (status == DownloadManager.STATUS_FAILED) {
                // 下载失败，获取错误原因
                int reason = cursor.getInt(cursor.getColumnIndex(DownloadManager.COLUMN_REASON));
                Log.e("Download", "下载失败，原因: " + reason);
            }
        }
        cursor.close();
    }
};

3. 适配Android版本的权限配置 #

• 若应用目标SDK低于29，需在AndroidManifest.xml中声明存储权限，并在运行时申请：

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

  运行时申请代码：

  if (ContextCompat.checkSelfPermission(this, Manifest.permission.WRITE_EXTERNAL_STORAGE)
          != PackageManager.PERMISSION_GRANTED) {
      ActivityCompat.requestPermissions(this, 
          new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE}, 1001);
  }
  

• Android 10及以上版本，使用setDestinationInExternalFilesDir无需额外存储权限，系统会自动分配应用私有外部存储权限。

4. 规范广播接收器的生命周期管理 #

将接收器注册移至onCreate，注销移至onDestroy，避免临时注册导致的异常：

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_pdf);
    // 注册下载完成广播接收器
    registerReceiver(onDownloadComplete, new IntentFilter(DownloadManager.ACTION_DOWNLOAD_COMPLETE));
}

@Override
protected void onDestroy() {
    super.onDestroy();
    // 注销接收器，避免内存泄漏
    try {
        unregisterReceiver(onDownloadComplete);
    } catch (IllegalArgumentException e) {
        e.printStackTrace();
    }
}

内容的提问来源于stack exchange，提问作者Cee.Dee