React Native中无法访问Firebase实时数据库问题求助

问题现象 #

• 已通过google-services.json完成Firebase项目初始化，console.log(database.ref)能返回正确数据库链接，但读写操作异常
• 带await的set操作卡住，finally块无法执行；不加await时本地快照更新，但Firebase控制台无数据同步
• 原本读取功能正常，修改Android项目app/build.gradle添加implementation platform('com.google.firebase:firebase-bom:30.2.0')后读写全失效，回滚修改后问题依旧

排查与解决步骤 #

1. 检查实时数据库安全规则 #

安全规则限制是最常见的读写失败原因，先临时开放规则测试：

{
  "rules": {
    ".read": true,
    ".write": true
  }
}

测试读写是否恢复，若恢复说明原规则限制了操作，需根据业务需求调整规则（比如仅允许认证用户读写）。

2. 清理依赖缓存并统一版本 #

即使回滚了build.gradle，缓存残留可能导致版本冲突：

• 执行Android Studio的File -> Invalidate Caches... -> Invalidate and Restart
• 手动删除项目根目录的.gradle文件夹和app模块的build文件夹，重新同步项目
• 建议使用Firebase BOM统一管理依赖版本，避免版本不一致：

// app/build.gradle的dependencies块中
implementation platform('com.google.firebase:firebase-bom:32.7.0') // 使用最新稳定版
implementation 'com.google.firebase:firebase-database'
implementation 'com.google.firebase:firebase-auth' // 若用到用户认证

3. 排查网络连接问题 #

实时数据库依赖WebSocket同步数据，需确保：

• 设备/模拟器能正常访问Firebase服务（可测试访问Firebase官网）
• 无代理、防火墙拦截WebSocket连接（默认端口为443）

4. 验证数据库实例指向 #

• 核对google-services.json中的database_url与Firebase控制台的数据库URL完全一致
• 若为多实例项目，需在代码中指定正确实例：

const database = firebase.database('https://your-specific-db-instance.firebaseio.com');

5. 修正异步操作逻辑 #

• 确保await操作在async函数内执行，否则会导致代码阻塞：

async function writeUserData() {
  try {
    await database().ref('users/123').set({ name: '5', age: 31 });
    console.log('写入成功');
  } catch (error) {
    console.error('写入失败:', error);
  } finally {
    console.log('操作完成');
  }
}
// 调用异步函数
writeUserData();

• 无await的set操作需通过then/catch确认远程同步结果，不要仅依赖本地快照：

database().ref('users').set('uid')
  .then(() => console.log('远程写入成功'))
  .catch(err => console.error('远程写入失败:', err));

内容的提问来源于stack exchange，提问作者Christie Joseph