设置Firebase Realtime Database离线模式以规避免费版读写限制

Firebase Realtime Database免费版限制如下：

• 同时连接数：100
• 存储容量：1GB
• 每月下载量：10GB
• 单项目多数据库：不支持

你遇到的核心问题是：Firebase Admin SDK的Python版本默认没有离线持久化功能。客户端SDK（Web/Android/iOS）自带离线缓存机制，但Admin SDK是为服务器端设计的，默认直接和云端交互，不存在本地存储逻辑，所以注释ref.push()根本不会改变同步行为。

下面给两种可行的解决方案：

方案1：用Firebase本地模拟器（推荐） #

Firebase Local Emulator Suite可以搭建完全隔离的本地Realtime Database，所有读写操作都在本地运行，完全不消耗云端额度，而且API和线上完全一致，调试体验最接近生产环境。

操作步骤： #

1. 安装Firebase CLI：

npm install -g firebase-tools

2. 初始化本地模拟器（如果没初始化过Firebase项目）：

firebase init emulators

执行后选择Realtime Database，设置端口（默认9000即可）。
3. 修改你的Python代码，把数据库URL指向本地模拟器：

from dotenv import load_dotenv
import os
import firebase_admin
from firebase_admin import credentials
from firebase_admin import db

load_dotenv()

# 调试时本地模拟器不需要证书，直接初始化
firebase_admin.initialize_app({
  # 把「你的项目ID」换成你Firebase控制台的项目ID
  'databaseURL': 'http://localhost:9000?ns=你的项目ID'
})

ref = db.reference('/a_reference')
ref.set({'data':'test'})
print(ref.get())

4. 启动本地模拟器：

firebase emulators:start --only database

然后运行你的Python代码，所有操作都在本地模拟器里，不会同步到云端。

方案2：手动封装本地存储（适合简单场景） #

如果不想折腾模拟器，也可以自己写个简单的本地存储层，调试时切换到本地，上线再切回Firebase。比如用JSON文件当本地数据库：

import json
from dotenv import load_dotenv
import os
import firebase_admin
from firebase_admin import credentials
from firebase_admin import db

# 调试开关：True用本地，False用线上
DEBUG_MODE = True

class LocalFirebaseDB:
    def __init__(self, file_name="local_db.json"):
        self.file_name = file_name
        self._load_data()

    def _load_data(self):
        try:
            with open(self.file_name, "r", encoding="utf-8") as f:
                self.db_data = json.load(f)
        except FileNotFoundError:
            self.db_data = {}

    def _save_data(self):
        with open(self.file_name, "w", encoding="utf-8") as f:
            json.dump(self.db_data, f, indent=2)

    def reference(self, path):
        # 封装路径操作，模拟Firebase的reference
        return _LocalReference(self, path)

class _LocalReference:
    def __init__(self, db_instance, path):
        self.db = db_instance
        self.path = path.strip("/").split("/")

    def set(self, value):
        current = self.db.db_data
        # 遍历路径层级
        for key in self.path[:-1]:
            if key not in current:
                current[key] = {}
            current = current[key]
        current[self.path[-1]] = value
        self.db._save_data()

    def get(self):
        current = self.db.db_data
        for key in self.path:
            if key not in current:
                return None
            current = current[key]
        return current

# 根据调试模式选择存储客户端
if DEBUG_MODE:
    db_client = LocalFirebaseDB()
else:
    cred = credentials.Certificate(os.getenv('FIREBASE_CREDENTIAL_PATH'))
    firebase_admin.initialize_app(cred, {
        'databaseURL': os.getenv('FIREBASE_DATABASE_URL')
    })
    db_client = db

# 调用方式和原来完全一致
ref = db_client.reference('/a_reference')
ref.set({'data':'test'})
print(ref.get())

两种方案对比： #

• 模拟器方案：完全复刻云端数据库的功能，支持查询、实时监听等高级操作，适合复杂调试场景。
• 手动封装方案：代码轻量，不需要额外工具，但只能实现基础的读写，复杂逻辑需要自己扩展。

内容的提问来源于stack exchange，提问作者Muhammad Ikhwan Perwira