Flutter使用fuzzywuzzy实现搜索栏时result为null问题求助

核心问题分析 #

你的代码中result为空主要有以下几个原因：

• choices参数类型不匹配：fuzzywuzzy的extractOne方法要求choices必须是List<String>类型。如果Firestore中Keywords字段不是字符串数组（比如存成单个字符串、数字列表，或者字段不存在），会导致extractOne无法正常匹配，直接返回null。
• 过滤逻辑完全无效：当前where方法里不管匹配结果如何都返回true，等于没有过滤，所有文档都会被保留，但这和你说的result为空的问题无关，属于额外的逻辑错误。
• cutoff与判断逻辑矛盾：你设置cutoff:10（最低匹配分），但判断条件是result.score >=80，如果所有匹配得分都低于80，result会直接返回null，此时访问result.score还会触发空指针异常。

修复后的代码 #

Future<List<DocumentSnapshot>> performFuzzySearch(String searchText) async {
    final querySnapshot = await FirebaseFirestore.instance.collection('Question Papers').get();

    final searchResults = querySnapshot.docs.where((doc) {
        // 先校验Keywords字段的合法性
        final keywords = doc["Keywords"];
        if (keywords == null || keywords is! List<String>) {
            return false;
        }

        print(keywords);
        print(searchText);
        
        // 将cutoff设为80，低于该分数的直接返回null
        final result = extractOne(
            query: searchText,
            choices: keywords,
            cutoff: 80,
        );

        // 仅保留匹配得分达标（result不为null）的文档
        return result != null;
    }).toList();

    searchResults.sort(
        (a, b) => b['Votes'].compareTo(a['Votes']),
    );

    return searchResults;
}

额外排查步骤 #

1. 确认Firestore字段类型：检查Question Papers集合中每个文档的Keywords字段，必须是字符串数组格式（比如["微积分", "期末考", "高数"]）。
2. 单独测试extractOne：脱离Firestore，用固定值测试方法是否正常工作，排除包本身的问题：

   // 测试代码
   final testResult = extractOne(query: "高数", choices: ["微积分", "期末考", "高数"], cutoff: 80);
   print(testResult); // 应返回匹配的结果对象
   

3. 检查包版本：确保fuzzywuzzy是最新版本，避免因版本bug导致的异常。

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