无法向Cloud Firestore添加信息：Android设备（API24）数据存储代码求助

我来帮你一步步分析为什么数据无法写入Cloud Firestore，按以下顺序排查：

1. 先整理你的代码片段（补全核心逻辑） #

首先把你提供的代码格式化并补全可能的写入逻辑，方便后续排查：

public class MainActivity extends AppCompatActivity {
    public static final String NUM_KEY="num";
    public static final String SMS_KEY="sms";
    private static final String TAG = "MainActivity";
    private DocumentReference mDocRef = FirebaseFirestore.getInstance().document("android/websms");

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        // 假设这里有触发写入的逻辑，比如按钮点击
    }

    // 核心写入方法（你可能遗漏了错误监听）
    private void saveData(String num, String sms) {
        Map<String, Object> data = new HashMap<>();
        data.put(NUM_KEY, num);
        data.put(SMS_KEY, sms);

        mDocRef.set(data)
                // 必须添加监听才能捕获错误！
                .addOnSuccessListener(new OnSuccessListener<Void>() {
                    @Override
                    public void onSuccess(Void unused) {
                        Log.d(TAG, "数据写入成功！");
                    }
                })
                .addOnFailureListener(new OnFailureListener() {
                    @Override
                    public void onFailure(@NonNull Exception e) {
                        Log.e(TAG, "写入失败原因: ", e);
                    }
                });
    }
}

2. 逐一排查可能的问题 #

（1）确认Firebase配置是否正确 #

• 确保google-services.json文件已正确放在app/目录下，且是从Firebase控制台对应项目下载的最新文件。
• 检查app级build.gradle的依赖是否齐全：

  implementation 'com.google.firebase:firebase-firestore:24.1.0' // 建议用最新版本
  implementation 'com.google.firebase:firebase-core:21.1.1'
  

• 根目录build.gradle需包含Google服务插件：

  classpath 'com.google.gms:google-services:4.3.15' // 最新版本即可
  

  且app级build.gradle末尾要添加apply plugin: 'com.google.gms.google-services'

（2）添加必要的网络权限 #

在AndroidManifest.xml中声明网络权限，API 24及以上虽无需动态申请，但必须声明：

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

没有网络权限会直接导致无法和Firestore服务器通信。

（3）检查Firestore安全规则 #

默认规则仅允许已认证用户读写数据，如果你还没实现用户认证，可暂时修改规则为开放（上线前务必改回严格规则！）：
打开Firebase控制台 → Firestore数据库 → 规则 → 修改为：

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /{document=**} {
      allow read, write: if true;
    }
  }
}

点击发布后再测试写入。

（4）确认文档路径和字段合法性 #

• 你的DocumentReference路径是"android/websms"，对应android集合下的websms文档，Firestore会自动创建不存在的集合/文档，但要确保路径没有拼写错误。
• 检查字段名和数据类型匹配：比如NUM_KEY对应的数据如果是数字类型，不要传入字符串，否则会导致写入失败。

（5）查看错误日志定位问题 #

一定要通过addOnFailureListener打印错误日志，Logcat里的具体错误信息（比如权限不足、路径错误、数据类型不匹配）是排查问题的关键。

3. 额外排查：离线缓存同步 #

Firestore默认开启离线缓存，若设备离线，数据会暂存本地，联网后自动同步。如果需要强制立即同步，可初始化时关闭离线持久化（不推荐生产环境使用）：

FirebaseFirestoreSettings settings = new FirebaseFirestoreSettings.Builder()
        .setPersistenceEnabled(false)
        .build();
FirebaseFirestore.getInstance().setFirestoreSettings(settings);

按照以上步骤排查，基本能定位到问题所在。如果还是不行，把Logcat里的错误日志贴出来，就能更精准地解决问题。

内容的提问来源于stack exchange，提问作者João Vieira