React Native应用无法连接Firebase实时数据库求助

问题描述 #

我的React Native应用使用Firebase Realtime Database已有数月，近期未修改代码却突然无法连接数据库。执行database().ref("ref").on("value", ...)无报错但始终无响应，查询.info/connected返回false。

查询代码：

import database from "@react-native-firebase/database";

database().ref(".info/connected").on("value", v => console.log("connected", v.val()));
database().ref(`/v2/teams/${teamID}`).on("value", v => console.log("team", v.val()));

package.json依赖：

"dependencies": {
    "@react-native-firebase/analytics": "15.3.0",
    "@react-native-firebase/app": "15.3.0",
    "@react-native-firebase/auth": "9.2.1",
    "@react-native-firebase/database": "7.5.5",
    "@react-native-firebase/functions": "15.3.0",
    "react": "16.13.1",
    "react-native": "0.63.2",
}

按官方教程创建空白测试项目也无法连接该数据库，但同一数据库的网页端访问正常，数据库负载与性能无异常，且无任何报错信息，不知从何入手排查。

排查步骤 #

1. 优先解决版本兼容性问题

• 你的@react-native-firebase/database版本（7.5.5）与核心@react-native-firebase/app版本（15.3.0）差异过大，这是连接失败的核心诱因。RN Firebase所有模块版本必须严格一致，否则会出现底层依赖冲突、通信协议不匹配问题。
• 解决方式：将所有@react-native-firebase/*模块统一升级/降级到同一稳定版本（需匹配React Native 0.63.2的兼容版本），比如把database和auth升级到15.x系列，或把app、analytics等降级到7.x系列。

2. 网络与基础配置排查

• 切换设备网络：尝试Wi-Fi/蜂窝网络互换，排除网络劫持、DNS污染导致的连接受阻。
• 验证Firebase配置文件：重新检查Android的google-services.json或iOS的GoogleService-Info.plist，确认数据库URL与网页端完全一致，无配置项误修改。
• 强制触发连接：在代码开头添加database().goOnline()，同时监听database().ref(".info/serverTimeOffset")，若该节点无响应，说明底层连接未建立。

3. Firebase控制台权限与状态检查

• 临时测试数据库规则：将数据库安全规则临时改为{ "rules": { ".read": true, ".write": true } }（测试后务必改回），验证是否因规则限制导致连接失败。
• 检查项目状态：确认Firebase项目未被暂停、欠费，数据库实例未被误删除。
• Android签名校验：检查Firebase控制台中配置的SHA-1证书指纹是否与当前应用签名一致，若近期更换签名文件会导致认证失败。

4. 日志与调试

• 开启数据库调试日志：在初始化数据库前添加database().setLoggingEnabled(true)，查看控制台输出的详细日志，里面会包含连接失败的具体原因（如握手错误、认证失败）。
• iOS ATS配置检查：确认Info.plist中未禁用ATS，或已正确配置Firebase域名的ATS例外。
• Android权限检查：确保AndroidManifest.xml中存在<uses-permission android:name="android.permission.INTERNET" />权限。

5. 缓存与构建清理

• 清理应用缓存：Android清除应用缓存，iOS卸载重装应用，排除本地旧配置干扰。
• 重建项目：删除node_modules、package-lock.json，执行npm install，再运行npx react-native clean清理构建缓存后重新打包。

内容的提问来源于stack exchange，提问作者Imperial Water