React Native安卓端Firebase/Firestore无法联网问题求助

针对你遇到的iOS正常但Android端Firestore无法连接的问题，我整理了几个常见的排查和解决方向，你可以逐一尝试：

1. 确认网络权限配置 #

首先检查AndroidManifest.xml中是否添加了必要的网络权限，Android应用默认不会自动授予联网权限：

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

这两个权限分别用于允许应用联网和检测网络状态，缺一不可。

2. 验证Firebase配置文件 #

确保google-services.json文件正确放置在Android/app目录下，并且该文件是从Firebase控制台针对你的Android应用下载的（包名要完全匹配Android/app/build.gradle中的applicationId）。如果文件错误或缺失，会导致Firebase无法正确初始化连接。

3. 检查依赖版本兼容性 #

你的build.gradle中使用的com.google.gms:google-services:4.3.4版本相对较旧，而Firebase JS包版本是7.23.0，版本不匹配可能导致底层通信异常：

• 建议将google-services升级到最新稳定版（比如4.3.15）
• 同时确保React Native Firebase包与Android端Firebase依赖版本兼容
• 另外，gradle:4.1.0对应的Gradle wrapper版本建议匹配（比如gradle-6.5-all.zip），可以检查gradle/wrapper/gradle-wrapper.properties中的distributionUrl是否正确

4. 配置Android 9+网络安全策略 #

由于你的targetSdkVersion=29（Android 10），系统默认会限制某些网络请求，即使是HTTPS也可能因配置问题受阻。可以创建网络安全配置文件：

1. 在res/xml目录下新建network_security_config.xml：

<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
    <base-config cleartextTrafficPermitted="true">
        <trust-anchors>
            <certificates src="system" />
        </trust-anchors>
    </base-config>
</network-security-config>

2. 在AndroidManifest.xml的application标签中添加引用：

<application
    ...
    android:networkSecurityConfig="@xml/network_security_config">

这个配置允许明文流量（虽然Firebase用HTTPS，但某些环境下可能需要），也可以后续更精准地只允许Firebase域名。

5. 排查离线模式与代码配置 #

检查你的Firestore初始化代码中是否强制开启了离线模式，比如：

firebase.firestore().enablePersistence({ synchronizeTabs: true })

虽然报错提示客户端进入离线模式，但有可能是代码配置导致的强制离线，而非真的网络问题。可以暂时注释掉离线相关配置，测试是否能正常连接。

6. 清除缓存并重新构建 #

缓存问题经常导致依赖加载异常，执行以下步骤清理后重新构建：

• 清理Android项目缓存：cd android && ./gradlew clean
• 重置React Native缓存：npx react-native start --reset-cache
• 重新安装依赖：npm install（或yarn install）

7. 验证设备/模拟器网络状态 #

确保你的Android模拟器或真机网络正常：

• 测试设备能否访问其他HTTPS网站（比如Google），排除设备本身的网络问题
• 模拟器可以尝试切换网络（比如从WiFi切换到移动数据），或重启模拟器解决网络延迟问题

8. 检查Firebase项目的应用配置 #

登录Firebase控制台，确认：

• Android应用的包名与你项目中的applicationId完全一致
• 已添加正确的SHA-1证书指纹（debug和release版本都需要添加，否则可能导致连接失败）

报错信息回顾：
@firebase/firestore: Firestore (7.23.0): Could not reach Cloud Firestore backend. Backend didn't respond within 10 seconds. This typically indicates that your device does not have a healthy Internet connection at the moment. The client will operate in offline mode until it is able to successfully connect to the backend.

内容的提问来源于stack exchange，提问作者Jatin Garg