Android通过URL下载图片至指定路径失败，求技术排查建议

我来帮你排查下这个图片保存失败的问题，看了你的代码，主要有几个关键问题导致路径创建失败和保存出错：

问题分析 #

• 错误的目录创建逻辑：你直接对schoolImage.jpg这个文件对象调用mkdir()，但mkdir()是用来创建目录的，不是文件。正确的做法应该先创建父目录EAcademy，再创建文件。
• 不安全的路径拼接：用字符串拼接dir+"/EAcademy"容易因路径分隔符（比如不同系统的/或\）导致路径错误，建议用File类的构造函数来处理路径层级。
• 未处理权限问题：Android 6.0（API 23）及以上版本，保存文件到外部存储需要动态申请WRITE_EXTERNAL_STORAGE权限；Android 10（API 29）及以上还要注意适配Scoped Storage（如果你的targetSdkVersion >=29）。
• 异常信息缺失：原代码只打印了“Failed to save”，没有输出具体异常详情，很难定位问题根源。

修复后的代码 #

class DownloadAndSaveImage(context: Context) : AsyncTask<String, Unit, Unit>() {
    private var mContext: WeakReference<Context> = WeakReference(context)

    override fun doInBackground(vararg params: String?) {
        val url = params[0] ?: return // 空值判断，避免空指针异常
        val requestOptions = RequestOptions()
            .override(100)
            .downsample(DownsampleStrategy.CENTER_INSIDE)
            .skipMemoryCache(true)
            .diskCacheStrategy(DiskCacheStrategy.NONE)

        mContext.get()?.let { context ->
            try {
                val bitmap = Glide.with(context)
                    .asBitmap()
                    .load(url)
                    .apply(requestOptions)
                    .submit()
                    .get()

                // 1. 正确构建DCIM目录下的目标子目录
                val dcimDir = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DCIM)
                val targetDir = File(dcimDir, "EAcademy")
                
                // 2. 创建目录（mkdirs()会递归创建所有不存在的父目录）
                if (!targetDir.exists()) {
                    val isDirCreated = targetDir.mkdirs()
                    if (!isDirCreated) {
                        Log.i("Tribhuwan", "Failed to create target directory")
                        return@let
                    }
                }

                // 3. 构建最终的文件对象
                val targetFile = File(targetDir, "schoolImage.jpg")
                
                // 4. 写入文件（use函数自动管理流的关闭，避免资源泄漏）
                FileOutputStream(targetFile).use { out ->
                    bitmap.compress(Bitmap.CompressFormat.JPEG, 85, out)
                    out.flush()
                    Log.i("Tribhuwan", "Saved Image successfully")
                }
            } catch (e: Exception) {
                Log.e("Tribhuwan", "Failed to save: ${e.message}", e) // 打印完整异常栈，方便排查
            }
        }
    }
}

额外注意事项 #

• 权限申请：在启动这个异步任务前，必须先申请存储权限：

  private const val PERMISSION_REQUEST_CODE = 1001
  
  // 检查并申请权限
  fun checkPermissionAndSaveImage(context: Context, imageUrl: String) {
      if (ContextCompat.checkSelfPermission(context, Manifest.permission.WRITE_EXTERNAL_STORAGE) 
          != PackageManager.PERMISSION_GRANTED) {
          ActivityCompat.requestPermissions(context as Activity, 
              arrayOf(Manifest.permission.WRITE_EXTERNAL_STORAGE), 
              PERMISSION_REQUEST_CODE)
      } else {
          DownloadAndSaveImage(context).execute(imageUrl)
      }
  }
  

• Android 10+适配：如果你的应用targetSdkVersion >=29，建议使用MediaStore API来保存图片（更符合Scoped Storage规范），或者在AndroidManifest.xml的<application>标签下添加android:requestLegacyExternalStorage="true"作为临时兼容方案。

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