Cloud Firestore文档结果存入ArrayList异常：仅能在onComplete内访问

问题的核心原因其实很简单：Cloud Firestore的查询是异步执行的，你写的onComplete回调方法，是在Firestore后台完成数据请求、把数据拉到本地之后才会触发的。而你在监听器外部写的代码（比如检查ArrayList大小、初始化ListView的Adapter），会比onComplete先执行——这时候ArrayList还完全没被填充，自然是空的。

举个直观的执行顺序例子：

1. 你调用db.collection(...).get().addOnCompleteListener(...)，Firestore开始在后台拉数据
2. 主线程继续往下走，执行你写的Log.d("TAG", "List size: " + arrayList.size())，此时arrayList还是空的，输出0
3. 过了几百毫秒（取决于网络速度），Firestore把数据拉回来了，触发onComplete方法，你才把数据加入ArrayList，这时候Toast能显示数据，但外部的代码早就跑完了

解决方法：把UI更新逻辑放到异步回调内部（或者用回调机制触发） #

这里给你三种常用的解决方案，你可以根据自己的代码复杂度选择：

方案1：直接在onComplete里初始化/更新Adapter #

这是最简单直接的方式，适合逻辑不复杂的场景：

// 先在类里声明成员变量，方便回调里访问
private ArrayList<String> yourDataList = new ArrayList<>();
private ArrayAdapter<String> listAdapter;
private ListView yourListView;

// 然后在查询数据的地方：
db.collection("你的集合名")
  .get()
  .addOnCompleteListener(new OnCompleteListener<QuerySnapshot>() {
      @Override
      public void onComplete(@NonNull Task<QuerySnapshot> task) {
          if (task.isSuccessful()) {
              yourDataList.clear(); // 先清空旧数据，避免重复添加
              for (QueryDocumentSnapshot document : task.getResult()) {
                  // 假设你要取的字段叫"content"，替换成你的实际字段名
                  String item = document.getString("content");
                  yourDataList.add(item);
                  Toast.makeText(getApplicationContext(), "已添加: " + item, Toast.LENGTH_SHORT).show();
              }

              // 在这里初始化或更新Adapter
              if (listAdapter == null) {
                  listAdapter = new ArrayAdapter<>(
                      getApplicationContext(),
                      android.R.layout.simple_list_item_1,
                      yourDataList
                  );
                  yourListView.setAdapter(listAdapter);
              } else {
                  // 如果Adapter已经初始化过，只需要通知它数据变化了
                  listAdapter.notifyDataSetChanged();
              }
          } else {
              Log.e("FirestoreError", "获取数据失败", task.getException());
          }
      }
  });

方案2：用自定义接口回调（适合逻辑拆分的场景） #

如果你的数据处理逻辑比较复杂，不想把所有代码都塞到onComplete里，可以用接口来解耦：

// 先定义一个回调接口
public interface OnFirestoreDataLoadedListener {
    void onDataLoaded(ArrayList<String> dataList);
    void onLoadFailed(Exception error);
}

// 封装一个加载数据的方法
private void loadFirestoreData(OnFirestoreDataLoadedListener listener) {
    db.collection("你的集合名")
      .get()
      .addOnCompleteListener(new OnCompleteListener<QuerySnapshot>() {
          @Override
          public void onComplete(@NonNull Task<QuerySnapshot> task) {
              if (task.isSuccessful()) {
                  ArrayList<String> dataList = new ArrayList<>();
                  for (QueryDocumentSnapshot document : task.getResult()) {
                      dataList.add(document.getString("content"));
                  }
                  listener.onDataLoaded(dataList);
              } else {
                  listener.onLoadFailed(task.getException());
              }
          }
      });
}

// 调用这个方法，在回调里处理UI
loadFirestoreData(new OnFirestoreDataLoadedListener() {
    @Override
    public void onDataLoaded(ArrayList<String> dataList) {
        // 在这里初始化Adapter并设置给ListView
        listAdapter = new ArrayAdapter<>(
            getApplicationContext(),
            android.R.layout.simple_list_item_1,
            dataList
        );
        yourListView.setAdapter(listAdapter);
    }

    @Override
    public void onLoadFailed(Exception error) {
        Toast.makeText(getApplicationContext(), "加载失败: " + error.getMessage(), Toast.LENGTH_SHORT).show();
    }
});

方案3：用LiveData（适合Jetpack架构的Android项目） #

如果你的项目用了Jetpack组件，用LiveData来观察数据变化会更优雅：

// 在ViewModel里定义LiveData（推荐把数据逻辑放到ViewModel中）
private MutableLiveData<ArrayList<String>> dataLiveData = new MutableLiveData<>();

public void loadFirestoreData() {
    db.collection("你的集合名")
      .get()
      .addOnCompleteListener(new OnCompleteListener<QuerySnapshot>() {
          @Override
          public void onComplete(@NonNull Task<QuerySnapshot> task) {
              if (task.isSuccessful()) {
                  ArrayList<String> dataList = new ArrayList<>();
                  for (QueryDocumentSnapshot document : task.getResult()) {
                      dataList.add(document.getString("content"));
                  }
                  dataLiveData.setValue(dataList);
              } else {
                  dataLiveData.setValue(null); // 用null标记加载失败
              }
          }
      });
}

// 在Activity/Fragment里观察LiveData
viewModel.dataLiveData.observe(this, new Observer<ArrayList<String>>() {
    @Override
    public void onChanged(ArrayList<String> dataList) {
        if (dataList != null) {
            listAdapter = new ArrayAdapter<>(
                getApplicationContext(),
                android.R.layout.simple_list_item_1,
                dataList
            );
            yourListView.setAdapter(listAdapter);
        } else {
            Toast.makeText(getApplicationContext(), "加载失败", Toast.LENGTH_SHORT).show();
        }
    }
});
viewModel.loadFirestoreData();

关键总结 #

所有Firebase的网络操作（包括Firestore查询、实时监听、Storage上传下载等）都是异步的，永远不要在回调外部直接使用还没被填充的数据。所有依赖这些数据的UI操作，都必须放到回调内部，或者通过回调接口、LiveData这类机制来触发。

内容的提问来源于stack exchange，提问作者Victor Aguilar