Firebase Functions对接Realtime Database模拟器写入数据失败如何解决？

问题原因与修复步骤 #

1. 修复异步逻辑，等待数据库写入完成再返回 #

你调用的database.ref().child('test').set("op")是异步操作，没等执行完成就调用了response.send，云函数收到返回指令后会直接冻结进程，未完成的写入操作会被直接中断，自然无法写入数据。修改为异步等待写法即可：

exports.textToLength = functions.https.onRequest(async (request, response) => {
    try {
        var tex = request.query.text;
        var textLength = tex.length;
        console.log(textLength);
        // 增加await等待写入操作完成
        await database.ref().child('test').set("op");
        response.send(String(textLength));
    } catch (e) {
        // 打印错误日志方便排查
        console.error("数据库写入失败：", e);
        response.status(500).send("写入失败");
    }
});

2. 配置Admin SDK连接本地Realtime Database模拟器 #

本地运行Functions模拟器时，Admin SDK默认会连接线上正式数据库，不会主动识别本地RTDB模拟器，需要手动指定模拟器地址：

• 首先调整启动命令，同时启动Functions和RTDB两个模拟器，不要只启动Functions
• 启动前配置环境变量指定RTDB模拟器地址，默认端口为9000，和你firebase.json里的配置保持一致即可

export FIREBASE_DATABASE_EMULATOR_HOST="localhost:9000"
firebase emulators:start --only functions,database

3. 修复依赖冲突消除Websocket警告 #

你在package.json里额外手动安装了@firebase/database-compat依赖，firebase-admin本身已经内置了对应兼容包，额外安装的版本和admin内置版本不匹配就会触发该警告，直接删除手动安装的兼容包即可：

cd functions
npm uninstall @firebase/database-compat
# 删除后重新安装依赖确保版本统一
npm install

4. 确认firebase.json配置正确 #

检查项目根目录的firebase.json里是否已经配置了RTDB模拟器相关参数，参考配置如下：

{
  "emulators": {
    "functions": {
      "port": 5001
    },
    "database": {
      "port": 9000
    },
    "ui": {
      "enabled": true
    }
  },
  "database": {
    "rules": "database.rules.json"
  }
}

以上操作全部完成后重启模拟器，再调用接口即可正常写入数据，Websocket警告也会同步消失。

内容的提问来源于stack exchange，提问作者Ayush Yadav