Firebase Storage getDownloadUrl()已废弃，如何获取长时下载URL？

我之前升级Firebase Storage到15.0.2版本的时候，也碰到过这个头疼的问题——原来的getDownloadUrl()突然就标红废弃了，官方一开始也没给明确的替代方案，折腾了好一阵才摸清楚正确的解决方式，分享给你：

为什么原来的方法会被废弃？ #

你贴的废弃代码是从StorageMetadata里同步获取下载URL的实现，这个方法被废弃主要有两个原因：

• 同步获取元数据的操作容易阻塞主线程，影响App性能；
• 元数据里的URL是临时的，可能会被Firebase自动轮换，长期保存后容易失效。

两种非废弃的获取方式 #

1. 客户端异步获取可访问URL（适合实时使用场景） #

官方现在推荐用StorageReference的异步getDownloadUrl()方法来获取，这个方法会直接从Firebase服务器获取最新的有效URL，只要用户有该文件的访问权限（比如文件设为公开，或者用户通过Auth验证有权限），就能正常使用。

替代代码示例：

// 假设你已经有了对应的StorageReference实例
StorageReference storageRef = FirebaseStorage.getInstance().getReference().child("path/to/your/file");

storageRef.getDownloadUrl().addOnSuccessListener(new OnSuccessListener<Uri>() {
    @Override
    public void onSuccess(Uri uri) {
        // 成功获取到下载URL
        String usableDownloadUrl = uri.toString();
        // 你可以把这个URL保存到数据库，或者直接用于下载、展示
    }
}).addOnFailureListener(new OnFailureListener() {
    @Override
    public void onFailure(@NonNull Exception e) {
        // 处理获取失败的情况，比如权限不足、文件不存在等
        Log.e("StorageError", "获取下载URL失败: " + e.getMessage());
    }
});

2. 后端生成签名URL（适合长期保存/分享场景） #

如果需要真正的长期有效URL（比如要保存到数据库里给用户长期访问，或者分享给没有App权限的第三方），就需要用Firebase Admin SDK在后端生成签名URL，这种URL可以自定义有效期（最长支持7天），不受客户端权限变化影响。

Java后端示例代码：

// 初始化Firebase Admin SDK（确保你已经配置了服务账号密钥）
Storage storage = StorageOptions.newBuilder()
        .setProjectId("你的项目ID")
        .setCredentials(ServiceAccountCredentials.fromStream(
                new FileInputStream("path/to/your/service-account-key.json")
        ))
        .build()
        .getService();

// 指定要生成URL的文件路径
BlobId blobId = BlobId.of("你的存储桶名称", "path/to/your/file");
Blob blob = storage.get(blobId);

// 设置URL的有效期，这里设置为7天
long expirationMillis = TimeUnit.DAYS.toMillis(7);
URL signedUrl = blob.signUrl(expirationMillis, TimeUnit.MILLISECONDS);

// signedUrl就是可以长期使用的下载链接
System.out.println("长期有效下载URL: " + signedUrl.toString());

注意事项 #

• 客户端获取的URL虽然不是永久的，但只要用户权限有效，Firebase会保证URL的可用性；如果需要长期保存，优先用后端生成的签名URL；
• 签名URL的有效期最长只能设为7天，这是Firebase的硬性限制，如果需要更长时间的访问，建议定期重新生成或者调整文件的存储规则为公开访问。

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