从Firebase Storage取图报错AttributeError的解决方法

问题根源 #

报错AttributeError: 'NoneType' object has no attribute 'download_as_string'的核心是bucket.get_blob()返回了None，说明系统在Firebase Storage中找不到指定路径的文件。

具体排查与解决步骤 #

• 核对文件路径与文件名

  1. 打印并检查实际请求路径：在代码中添加print(f"Requesting file: Images/{id}.png")，然后去Firebase Storage控制台核对该路径下的文件是否存在。
  2. 注意路径大小写：Firebase Storage路径区分大小写，确认文件夹名是Images而非images，文件扩展名是.png而非.PNG或其他格式。
  3. 验证id变量的有效性：检查id是否包含空格、特殊字符，或者是否与存储中实际的文件ID匹配。

• 检查存储权限与服务账号

  1. 确认存储桶规则允许读取：临时测试可使用宽松规则（生产环境需调整为安全规则）：

     service firebase.storage {
       match /b/{bucket}/o {
         match /{allPaths=**} {
           allow read, write: if true;
         }
       }
     }
     

  2. 重新获取服务账号密钥：如果服务账号权限变更或密钥过期，去Firebase控制台重新下载密钥文件并替换到项目中。

• 代码优化与兼容

  1. 添加空值判断，避免崩溃：

     blob = bucket.get_blob(f'Images/{id}.png')
     if blob is None:
         print(f"File not found: Images/{id}.png")
         # 替换为你的默认图片处理逻辑
         imgStudent = cv2.imread('path/to/default.png')
     else:
         # 推荐使用download_as_bytes()替代已弃用的download_as_string()
         array = np.frombuffer(blob.download_as_bytes(), np.uint8)
         imgStudent = cv2.imdecode(array, cv2.COLOR_BGRA2BGR)
     

  2. 替换弃用方法：download_as_string()在新版SDK中已被标记为弃用，改用download_as_bytes()可避免潜在的兼容性问题。

• 检查文件状态与缓存

  1. 重新上传文件：如果文件存在但无法获取，尝试删除后重新上传，确保文件完全同步到存储桶。
  2. 排查生命周期规则：确认是否设置了自动删除或归档文件的规则，导致目标文件被移除。

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