Python操作Firebase Realtime Database报实例未激活错误原因问询
错误含义
firebase_admin.exceptions.UnavailableError: Firebase database instance is inactive 表示目标Firebase实时数据库实例处于非活跃状态,服务端拒绝处理当前的读写请求。
常见触发原因
- 免费套餐自动休眠:若使用Firebase Spark免费套餐,当数据库连续7天无任何访问请求时,平台会自动将实例休眠以节约资源,休眠期间的所有读写请求都会返回该错误。首次访问触发唤醒后1~2分钟即可恢复正常服务,该情况通常仅在长时间无访问后的首次请求时偶发。
- 服务被关停或欠费冻结:项目存在欠款时,Google会自动冻结名下所有云服务;或是管理员在Firebase控制台手动停用了实时数据库服务,都会返回实例未激活的报错,该场景下报错会常态化出现。
- 初始化逻辑存在缺陷:当前代码的
init_client方法中,对options的空值判断放在了initialize_app执行之后,如果auth_config.firebase_config_json()返回空值或databaseURL字段缺失/错误,初始化过程不会立刻抛出异常,但实际发起请求时会指向无效实例,触发该报错。 - 实例区域不匹配:如果数据库实例创建时选择了非美国默认区域,而配置的
databaseURL没有携带对应区域标识,请求会被路由到错误的集群,被判定为实例不存在或未激活,该场景下报错同样会常态化出现。
内容的提问来源于stack exchange,提问作者WJA
相关产品推荐
相关产品推荐

