Android Firebase按输入字母匹配列表时String转List报错排查

java.lang.ClassCastException: java.lang.String cannot be cast to java.util.List 错误是因为你读取的Firestore文档products/qQIJ9oGjlwwqNObfVV6U中的name字段存储的是单个字符串类型，但代码中强制将其转换为List<String>，类型不匹配导致抛出异常。你可以先登录Firestore控制台确认该字段的存储格式。

场景1：你需要将所有产品名存储在该单文档的name字段中 #

首先将Firestore中该文档的name字段修改为数组类型，存入所有产品名字符串。然后替换原有强转代码，使用Firestore提供的类型安全读取方法：

// 替换该行代码
// List<String> productNameList = (List<String>) document.get("name");
// 改为如下代码
List<String> productNameList = document.getStringList("name");

场景2：你需要获取products集合下所有文档的name字段组成列表 #

你原有逻辑只读取了单个固定文档，需要改为遍历整个集合的文档提取name字段，示例代码如下：

private FirebaseFirestore rootRef = FirebaseFirestore.getInstance();
private CollectionReference productsRef = rootRef.collection("products");

MutableLiveData<List<String>> getProductNameListMutableLiveData() {
    MutableLiveData<List<String>> productNameListMutableLiveData = new MutableLiveData<>();
    productsRef.get().addOnCompleteListener(task -> {
        if (task.isSuccessful()) {
            List<String> productNameList = new ArrayList<>();
            for (QueryDocumentSnapshot document : task.getResult()) {
                String name = document.getString("name");
                if (name != null) {
                    productNameList.add(name);
                }
            }
            productNameListMutableLiveData.setValue(productNameList);
        } else {
            Log.d(Constants.TAG, task.getException().getMessage());
        }
    });
    return productNameListMutableLiveData;
}

拿到全量产品名列表后，可通过以下逻辑过滤匹配用户输入的内容：

// inputText 为用户输入的字符
List<String> matchedList = productNameList.stream()
    .filter(name -> name.toLowerCase().contains(inputText.toLowerCase()))
    .collect(Collectors.toList());
// 将matchedList更新到列表适配器即可展示匹配结果

如果产品数据量较大，建议直接使用Firestore查询过滤，无需全量拉取数据：

// 匹配以用户输入字符开头的产品名，可提前存储全小写的name索引字段实现大小写不敏感匹配
Query query = productsRef.whereGreaterThanOrEqualTo("name", inputText)
    .whereLessThanOrEqualTo("name", inputText + "\uf8ff");

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