如何在Kotlin中通过URL删除Firebase Storage中的图片？

核心结论 #

Firebase Java/Admin SDK 确实没有直接通过URL获取存储引用的API（比如Node.js的getFileFromUrl或旧版的getReferenceFromUrl），但可以通过解析URL提取文件路径，再通过路径获取引用并删除文件。

实现步骤 #

1. 解析Storage URL提取文件路径 #

Firebase Storage的URL主要有两种格式，对应不同的解析方式：

• gs://格式（存储桶原生URL）：例如 gs://your-bucket-name/path/to/image.jpg，直接截取gs://bucket-name/之后的部分作为文件路径。
• HTTPS下载URL：例如 https://firebasestorage.googleapis.com/v0/b/your-bucket-name/o/path%2Fto%2Fimage.jpg?alt=media&token=xxx，需要提取o/和?之间的字符串，再解码URL编码的特殊字符（比如%2F替换为/）。

可以封装一个工具函数来处理两种URL：

fun extractStoragePathFromUrl(url: String): String {
    return when {
        url.startsWith("gs://") -> {
            // 处理gs://格式
            url.substringAfter("gs://${StorageClient.getInstance().bucketName}/")
        }
        url.startsWith("https://firebasestorage.googleapis.com") -> {
            // 处理HTTPS下载URL
            val encodedPath = url.substringAfter("/o/").substringBefore("?")
            java.net.URLDecoder.decode(encodedPath, "UTF-8")
        }
        else -> throw IllegalArgumentException("Unsupported Storage URL format")
    }
}

2. 通过路径获取引用并删除文件 #

拿到文件路径后，即可通过StorageClient获取存储桶引用，再定位到具体文件并执行删除：

import com.google.firebase.cloud.StorageClient

// 示例：从URL删除文件
fun deleteFileFromStorageUrl(imageUrl: String) {
    try {
        val filePath = extractStoragePathFromUrl(imageUrl)
        val storage = StorageClient.getInstance()
        // 获取文件引用
        val fileRef = storage.bucket.get(filePath)
        // 执行删除
        fileRef.delete()
        println("文件删除成功")
    } catch (e: Exception) {
        println("删除失败：${e.message}")
    }
}

替代方案：直接通过已知路径删除 #

如果你已经知道文件在Storage中的完整路径（比如上传时记录的路径），可以跳过URL解析，直接通过路径删除：

fun deleteFileByPath(filePath: String) {
    val storage = StorageClient.getInstance()
    storage.bucket.get(filePath).delete()
}

注意事项 #

• 确保你的Admin SDK服务账号拥有storage.objects.delete权限，否则会出现权限错误。
• 解析HTTPS URL时，注意处理没有token参数的情况（比如公开访问的文件URL，可能只有?alt=media），上述代码的substringBefore("?")可以兼容这种情况。

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