下载服务无法正常工作怎么办？附相关代码片段

嘿，我看到你用IntentService实现下载功能，但只贴了部分代码。结合Android下载场景的常见坑，我先给你梳理几个最可能出问题的地方：

1. 权限问题（最容易踩的坑） #

Android 6.0（API 23）及以上版本，存储权限需要动态申请，如果直接调用Environment.getExternalStorageDirectory()却没获取权限，大概率会触发FileNotFoundException或者写入失败：

• 修复步骤：
  • 先在AndroidManifest.xml里声明基础权限：

    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
    <!-- Android 10+ 还需添加这个权限 -->
    <uses-permission android:name="android.permission.MANAGE_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);
    } else {
        // 权限已获取，启动下载服务
        startService(new Intent(this, YourDownloadService.class));
    }
    

2. IntentService的特性限制 #

IntentService是一次性服务，处理完一个Intent就会自动停止，如果下载任务还没完成就被销毁，下载会直接中断。另外Android 8.0（API 26）及以上，后台服务启动受限，直接用IntentService很容易被系统杀死：

• 修复建议：
  • 改用ForegroundService，下载时显示前台通知，避免被系统回收：

    @Override
    protected void onHandleIntent(Intent intent) {
        // 创建前台通知模板
        NotificationCompat.Builder builder = new NotificationCompat.Builder(this, "download_channel")
                .setSmallIcon(R.drawable.ic_download)
                .setContentTitle("正在下载VR视频")
                .setContentText("下载进度...")
                .setPriority(NotificationCompat.PRIORITY_LOW);
        
        // 启动前台服务
        startForeground(1, builder.build());
        
        // 在这里执行你的下载逻辑
    }
    

  • 别忘了在AndroidManifest.xml里声明前台服务权限：

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

3. 下载逻辑的细节漏洞 #

你贴的代码里用到了BufferedInputStream和FileOutputStream，但可能存在这些隐性问题：

• 流未正确关闭：下载完成后必须关闭输入输出流，否则会导致文件损坏或资源泄漏，推荐用try-with-resources语法自动管理：

  try (InputStream inputStream = new BufferedInputStream(url.openStream());
       FileOutputStream outputStream = new FileOutputStream(targetFile)) {
      byte[] buffer = new byte[1024];
      int bytesRead;
      while ((bytesRead = inputStream.read(buffer)) != -1) {
          outputStream.write(buffer, 0, bytesRead);
      }
  } catch (IOException e) {
      Log.e("DownloadService", "下载失败", e);
  }
  

• 路径兼容性问题：Android 10+推荐用分区存储，直接用Environment.getExternalStorageDirectory()可能无法写入，建议改用应用专属存储路径：

  // 获取应用专属的下载目录，无需额外权限
  File targetFile = new File(getExternalFilesDir(Environment.DIRECTORY_DOWNLOADS), "vr_video.mp4");
  

4. 日志定位法 #

你已经用了Log，但建议在关键节点加日志：比如权限申请结果、文件路径是否存在、输入流是否成功打开、写入字节数、异常堆栈信息，这样能快速定位到具体哪一步出错。

如果上面的排查点都试过还是有问题，把onHandleIntent里的完整下载逻辑贴出来，我再帮你精准定位~

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