Kotlin中Firebase Realtime Database图片下载异常排查

已完成Firebase Realtime Database中图片、数据在RecyclerView的加载展示，每个条目内置下载按钮用于下载对应图片，点击下载按钮后无任何下载响应，Logcat输出报错：

Firebase Storage URLs must point to an object in your Storage Bucket. Please obtain a URL using the Firebase Console or getDownloadUrl()

布局效果参考：

• 调用getReferenceFromUrl()时传入的是Firebase Realtime Database的服务地址（https://notes-72413.firebaseio.com/），Realtime Database和Firebase Storage是两个独立服务，地址不通用，该地址不属于Storage存储桶地址，直接触发参数错误
• 下载逻辑硬编码了存储路径abstract、本地保存文件名imageName.txt，没有和当前点击条目的真实图片资源绑定，即使地址修正也无法下载用户选中的对应图片
• 本地存储路径使用外部存储根目录，没有适配Android 10+分区存储规则，也未做权限适配，后续会出现文件写入失败问题

1. 修正Storage引用初始化 #

不要传入Realtime Database的服务地址，直接获取Firebase Storage默认实例的根引用即可，若使用非默认存储桶，传入gs://开头的存储桶地址。

2. 绑定点击条目和下载参数 #

在条目点击事件中，将当前位置对应的图片存储路径、自定义文件名传入下载方法，替换硬编码的路径和文件名。

3. 修正本地存储路径 #

使用应用专属外部存储目录保存下载文件，该目录无需申请存储权限即可读写，适配全版本Android系统。

Adapter绑定逻辑修改 #

override fun onBindViewHolder(holder: ViewHolder, position: Int) {
    val currentAbstract = abstractList[position]
    // 原有图片加载逻辑保持不变
    Glide.with(mContext)
        .load(currentAbstract.abstract)
        .into(holder.imageView)

    // 点击时传入当前条目的图片路径、自定义保存文件名
    holder.download_btn.setOnClickListener {
        downloadFile(
            storagePath = currentAbstract.abstract,
            saveName = "abstract_img_${System.currentTimeMillis()}.jpg"
        )
    }
}

下载方法修改 #

private fun downloadFile(storagePath: String, saveName: String) {
    val storage = FirebaseStorage.getInstance()
    // 获取Storage根引用，不再传入错误的Realtime Database地址
    val storageRef = storage.reference
    // 传入当前条目的图片真实路径，替换硬编码的"abstract"
    val imageRef = storageRef.child(storagePath)

    // 保存到应用专属图片目录，无需存储权限
    val saveDir = File(mContext.getExternalFilesDir(Environment.DIRECTORY_PICTURES), "abstracts")
    if (!saveDir.exists()) {
        saveDir.mkdirs()
    }
    val localFile = File(saveDir, saveName)

    imageRef.getFile(localFile)
        .addOnSuccessListener {
            Log.d(Tag, "图片下载成功，保存路径：$localFile")
            // 可在此添加下载成功提示、通知相册刷新等逻辑
        }
        .addOnFailureListener { e ->
            Log.e(Tag, "图片下载失败：${e.message}", e)
        }
}

• 如果你在Realtime Database中存储的abstract字段是https://开头的图片公网下载链接，而非Storage中的相对路径，可直接通过该http链接初始化Storage引用：storage.getReferenceFromUrl(storagePath)，不需要再调用child()方法
• 如果需要将图片保存到系统公共相册目录，需适配Android版本申请对应媒体读取权限，通过MediaStore API完成写入，不要直接操作外部存储根目录
• 提前检查Firebase Storage安全规则配置，确保应用拥有对应文件的读取权限，否则会抛出权限拒绝错误

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