如何通过本地路径上传图片至Firebase Storage并自定义存储路径

原代码触发ValueError: unknown file extension来自三个错误写法：

• Image.save()未传入输出路径参数，返回值为None，将None作为文件路径调用open()本身逻辑不成立
• 初始化Blob对象时传入空字符串作为存储路径，Firebase SDK无法解析目标文件后缀，直接抛出扩展名未知错误
• 多余引入PIL做图片打开、转存操作，本地路径可直接读取上传，冗余步骤反而引入额外异常。

无需通过PIL转存，直接读取本地文件流上传即可，注意Blob初始化时必须传入带合法后缀的存储路径，推荐显式指定文件Content-Type避免SDK识别异常，参考实现：

import os
from firebase_admin import storage

# 存储桶对象仅需初始化一次，放在循环外减少开销
bucket = storage.bucket()
public_photo_urls = []

for image_abs_path in listing.photos:
    # 跳过本地不存在的文件，避免IO报错
    if not os.path.isfile(image_abs_path):
        continue
    # 提取原文件后缀、文件名
    file_name = os.path.basename(image_abs_path)
    file_ext = os.path.splitext(file_name)[1].lstrip('.').lower()
    
    with open(image_abs_path, 'rb') as image_file:
        # 初始化Blob，指定存储文件名
        blob = bucket.blob(file_name)
        # 显式指定内容类型，避免后缀识别错误
        blob.upload_from_file(
            image_file,
            content_type=f"image/{file_ext}"
        )
        blob.make_public()
        public_photo_urls.append(blob.public_url)

Firebase Storage不需要提前手动创建目录，初始化Blob时直接传入完整的目标路径（正斜杠/分隔层级），SDK会自动生成对应层级的目录结构。
如果需要将同一条listing的图片存在/listingImages/[唯一ID]/路径下，提前生成业务唯一ID（可以直接使用业务侧的ref ID，也可以用UUID生成随机唯一标识），拼接进Blob路径即可，参考实现：

import os
import uuid
from firebase_admin import storage

bucket = storage.bucket()
public_photo_urls = []
# 生成唯一目录ID，如有现成业务ref ID直接替换该行即可
listing_ref_id = str(uuid.uuid4())

for index, image_abs_path in enumerate(listing.photos):
    if not os.path.isfile(image_abs_path):
        continue
    file_ext = os.path.splitext(image_abs_path)[1].lower()
    # 自定义存储文件名，这里用序号命名避免原文件名重名冲突，也可保留原文件名
    save_file_name = f"{index}{file_ext}"
    # 拼接完整存储路径，注意路径开头不要加斜杠
    target_blob_path = f"listingImages/{listing_ref_id}/{save_file_name}"
    
    blob = bucket.blob(target_blob_path)
    with open(image_abs_path, 'rb') as image_file:
        blob.upload_from_file(
            image_file,
            content_type=f"image/{file_ext.lstrip('.')}"
        )
    blob.make_public()
    public_photo_urls.append(blob.public_url)

注意事项 #

• Blob存储路径不要以/开头，否则会在存储桶根目录生成无名称的冗余节点
• 上传时显式传入content_type参数，可彻底规避SDK路径解析导致的文件类型、扩展名识别错误
• 如不需要公网可访问图片，可删除blob.make_public()调用，改用签名URL方式做访问鉴权
• 文件读取推荐使用with上下文管理器，自动释放文件句柄，避免资源泄漏

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