Firestore模拟器UI提示仅支持默认数据库且无数据显示问题排查

以下是针对该问题的几个具体排查方向：

• Firebase CLI版本差异
  台式机与笔记本的Firebase CLI版本可能不一致，旧版本模拟器UI对默认数据库的识别逻辑存在bug。分别在两台机器执行firebase --version对比版本，若版本不同，将笔记本的CLI升级到最新稳定版：

  npm install -g firebase-tools
  

• Flutter应用数据库实例配置错误
  尽管请求已命中模拟器，但代码可能指定了非默认数据库实例，导致数据写入了模拟器UI不支持显示的非默认库。检查Flutter代码中Firestore初始化逻辑，确保未指定自定义databaseId，避免使用：

  FirebaseFirestore.instanceFor(databaseId: "custom-db");
  

  直接使用默认实例：

  FirebaseFirestore.instance;
  

• 导入/导出目录权限问题
  笔记本上的firebase/dump目录可能存在权限不足，导致模拟器无法正确读取备份或写入导出数据，进而影响UI的数据加载。执行以下命令检查并调整权限：

  ls -l firebase/dump
  chmod -R 755 firebase/dump
  

• firebase.json配置结构错误
  虽然添加了"database": "default"，但配置位置可能不正确。正确的配置需要确保在firestore全局节点或emulators下的firestore节点中指定，示例配置：

  {
    "firestore": {
      "database": "default"
    },
    "emulators": {
      "firestore": {
        "port": 8080,
        "database": "default"
      }
    }
  }
  

  检查配置后重启模拟器。

• 模拟器缓存或残留进程干扰
  笔记本可能存在模拟器残留进程或缓存文件，导致数据库实例识别异常。执行以下步骤清理后重启：

  firebase emulators:stop
  rm -rf ~/.cache/firebase/emulators
  

• 端口绑定或连接配置不一致
  检查模拟器启动日志，确认Firestore模拟器绑定的端口（默认8080），同时确保Flutter代码中指定的连接端口与UI访问的端口一致：

  FirebaseFirestore.instance.useFirestoreEmulator('localhost', 8080);
  

内容的提问来源于stack exchange，提问作者Eray Erdin