讲师中心 微信公众号
AI工具推荐 视频效率加速

如何正确获取 Firebase Storage 上传图片的下载 URL

夜敏君_9939

夜敏君_9939

发布时间:2026-07-11 17:14:24

|

590人浏览过

|

来源于php中文网

原创

Firebase Storage 报错“Object does not exist at location”(404)的根本原因是:上传时使用的 StorageReference 与调用 getDownloadUrl() 时的引用不一致,导致系统尝试从空/错误路径读取 URL。本文详解问题成因、修复方案及最佳实践。

firebase storage 报错“object does not exist at location”(404)的根本原因是:上传时使用的 storagereference 与调用 `getdownloadurl()` 时的引用不一致,导致系统尝试从空/错误路径读取 url。本文详解问题成因、修复方案及最佳实践。

在使用 Firebase Storage 上传文件后立即获取下载地址时,一个常见却极易被忽视的错误是引用对象不统一。你当前的代码中:

  • 上传操作使用的是 ref.child(postId+"-"+fmNumber).putFile(result) —— 即指向具体子路径(如 "photo/123456-ABC123");
  • 而获取下载 URL 时却调用了 ref.getDownloadUrl() —— 此处 ref 是根引用 FirebaseStorage.getInstance().getReference("photo"),它本身并未指向已上传的文件,因此 Firebase 尝试从该“空容器”路径请求 URL,自然返回 404。

✅ 正确做法是:复用同一个 StorageReference 实例,确保上传与获取 URL 操作作用于完全相同的文件路径。

以下是修复后的关键代码段(基于 Java,适配 Android):

// ✅ 定义明确的文件引用(含唯一路径)
StorageReference fileRef = ref.child(postId + "-" + fmNumber);

// ✅ 使用同一 fileRef 执行上传
fileRef.putFile(result)
    .addOnSuccessListener(taskSnapshot -> {
        // ✅ 再次使用同一 fileRef 获取下载 URL
        fileRef.getDownloadUrl()
            .addOnSuccessListener(uri -> {
                String downloadUrl = uri.toString();
                System.out.println("Download URL: " + downloadUrl);
                image = downloadUrl;
                Toast.makeText(FromActivity.this, "Image Upload Successful", Toast.LENGTH_SHORT).show();
                uploadComplete = true;
            })
            .addOnFailureListener(exception -> {
                // ❗注意:getDownloadUrl() 在旧版 SDK 中已被弃用,推荐使用 getMetadata()
                Toast.makeText(FromActivity.this, "Failed to get download URL", Toast.LENGTH_SHORT).show();
                Log.e("Storage", "getDownloadUrl failed", exception);
            });
    })
    .addOnFailureListener(exception -> {
        Toast.makeText(FromActivity.this, "Upload failed: " + exception.getMessage(), Toast.LENGTH_SHORT).show();
        uploadComplete = false;
    });

⚠️ 重要注意事项:

  • getDownloadUrl() 已弃用(自 Firebase SDK v20.0.0+):官方推荐改用 getMetadata() 后拼接 URL,或更稳妥地——在上传成功后直接从 taskSnapshot.getMetadata().getReference().getDownloadUrl() 获取(该方式保证强一致性且无需额外网络请求):

    fileRef.putFile(result)
        .addOnSuccessListener(taskSnapshot -> {
            // ✅ 推荐:从上传结果中直接提取下载 URL(无额外请求,零延迟,100% 可靠)
            taskSnapshot.getMetadata().getReference().getDownloadUrl()
                .addOnSuccessListener(uri -> {
                    image = uri.toString();
                    System.out.println("✅ Final URL: " + image);
                });
        });
  • 路径唯一性与安全性:postId + "-" + fmNumber 需确保全局唯一,避免覆盖;生产环境建议使用 UUID.randomUUID().toString() 或 FirebaseFirestore.getInstance().collection("dummy").document().getId() 生成防冲突 ID。

  • 权限检查:确认 Firebase Storage Security Rules 允许读取对应路径,例如:

    match /photo/{imageId} {
      allow read: if true; // 或更严格的 auth 条件
      allow write: if request.auth != null;
    }

总结:解决 StorageException: Object does not exist at location (404) 的核心在于路径引用的一致性与时效性。始终复用上传所用的 StorageReference,优先从 UploadTask.TaskSnapshot 中提取元数据和 URL,既能规避竞态问题,又能提升健壮性与性能。

热门AI工具

更多
VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

相关专题

更多
Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

200

2026.09.23

Buffalo框架路由与请求处理实操指南
Buffalo框架路由与请求处理实操指南

本专题讲解Buffalo框架路由与请求处理机制,涵盖路由注册与分组、资源路由、Handler编写规范、Context上下文方法、参数绑定、中间件编写挂载、Session与Cookie读写、Flash消息及错误页面定制方法。

100

2026.09.23

Buffalo框架零基础入门教程
Buffalo框架零基础入门教程

本专题整理Buffalo框架入门内容,涵盖Go环境准备、buffalo CLI安装、新项目生成、目录结构说明、dev热加载启动、数据库连接配置与常见报错排查,帮助新手按约定优于配置的思路跑通第一个Buffalo框架应用。

80

2026.09.23

Conan创建软件包配方指南
Conan创建软件包配方指南

本专题介绍通过conanfile.py创建软件包的方法,讲解包名、版本、依赖和构建设置等基础信息,以及source、build、package、package_info等常用方法的作用及编写思路。

60

2026.09.22

Conan二进制包配置指南
Conan二进制包配置指南

本专题介绍Conan根据操作系统、编译器、架构和构建类型生成二进制包的方法,讲解Profile、Settings、Options及Package ID的作用,帮助管理不同平台和编译环境下的包版本。

60

2026.09.22

Conan私有仓库搭建教程
Conan私有仓库搭建教程

本专题系统的讲解Conan私有仓库的搭建流程,涵盖仓库服务部署、存储目录配置、用户认证、权限划分和远程地址添加,并介绍内部C++依赖包的上传、下载及版本维护方法。

60

2026.09.22

loomy官网入口地址合集
loomy官网入口地址合集

本专题汇总了 Loomy 桌面 AI 助理的官方入口地址合集及使用指南。提供 macOS 与 Windows 客户端下载 。Loomy 是讯飞推出的桌面级 AI 工作搭子,支持文件整理、数据分析、网页操作及通过飞书/钉钉远程操控电脑,助你高效完成本地办公任务 。

60

2026.09.22

NumPy常见函数使用方法
NumPy常见函数使用方法

本专题整理 NumPy 常见函数使用方法相关教程,覆盖函数大全、参数用法、数组运算、统计聚合、排序处理、where 条件筛选、linspace 创建数列等常用场景,帮助读者快速掌握 NumPy 函数调用思路和实际数据处理技巧。

80

2026.09.22

NumPy性能优化版本更新与常见报错排查
NumPy性能优化版本更新与常见报错排查

本专题整理 NumPy 性能优化、版本更新与常见报错排查相关教程,覆盖向量化计算、广播性能、内存布局、NumPy 2.0 升级、版本兼容冲突、安装导入报错、dtype 溢出、矩阵运算异常和 broadcasting 报错修复,帮助读者系统掌握 NumPy 性能调优与问题定位方法。

100

2026.09.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn