Flutter对接Firebase实现用户搜索时NoSuchMethodError报错排查

Exception has occurred.
NoSuchMethodError (NoSuchMethodError: The method 'then' was called on null.
Receiver: null
Tried calling: then(Closure: (dynamic) => Null))

该错误是自定义的searchByName方法未返回查询对象导致的：方法内执行了Firebase Firestore的get()查询操作，但没有写return关键字返回查询结果对应的Future对象，方法默认返回null，外层代码对null调用.then()方法时直接触发异常。

1. 修正searchByName方法，明确返回查询Future #

给Firestore查询语句加上return，声明正确的返回类型：

Future<QuerySnapshot> searchByName(String username) {
  return FirebaseFirestore.instance
      .collection("users")
      .where("username", isEqualTo: username)
      .get();
}

2. 优化搜索逻辑，补全页面刷新触发 #

原代码拿到查询结果后没有调用setState通知页面重绘，即使拿到结果也不会显示搜索列表；同时去掉冗余的async/await和.then()混用写法、移除循环内重复赋值的无效逻辑：

initiateSearch() async {
  // 先对输入做首尾空格去除，避免无意义空格导致查询无结果
  String searchKey = searchEditingController.text.trim();
  if (searchKey.isNotEmpty) {
    QuerySnapshot queryRes = await databaseMethods.searchByName(searchKey);
    setState(() {
      searchResultSnapshot = queryRes;
    });
  }
}

当前实现是用户名精确匹配查询，只能搜到和输入内容完全一致的用户，可根据业务需求选择以下更灵活的搜索方案：

• 前缀匹配搜索：不需要引入额外服务，直接修改Firestore查询条件即可实现输入开头字符联想匹配效果，查询写法为where("username", isGreaterThanOrEqualTo: 搜索关键词, isLessThan: 搜索关键词 + '\uf8ff')，适合简单的用户名搜索场景。
• 专业搜索引擎对接：如果需要支持全文模糊匹配、拼写纠错、多字段联合搜索（同时匹配昵称、用户名、个性签名等字段），可以在用户数据写入Firestore时，同步将数据同步到Algolia、Typesense等专门的搜索服务，由搜索服务对外提供查询接口，是Firebase生态下应对复杂搜索需求的通用方案。
• 本地缓存过滤：如果平台总用户量在万级以内，可以在应用启动时一次性拉取全量公开用户信息缓存到本地，搜索时直接在本地做字符串匹配过滤，查询响应速度更快，也能减少Firestore的读操作计费成本。

内容的提问来源于stack exchange，提问作者Hüseyin Çavuş