Kotlin 新手求助：RecyclerView 搜索功能不工作，如何正确实现 SearchView 过滤逻辑？😫

开

开发者小王

6/27/2025

9 views2 likes

救命！我的RecyclerView搜索功能就是搞不定啊！(╯°□°)╯︵ ┻━┻

嗨各位大佬！我是Android开发新手，之前有VB.NET背景，现在正在做我的第一个Android应用（Kotlin）。我遇到了一个RecyclerView搜索功能的问题，已经折腾好几天了，看了无数YouTube教程还是搞不定 😫

我的问题

我已经成功用RecyclerView显示了手机通讯录联系人列表，但是搜索功能完全不起作用！每次输入文字，列表要么不变，要么就清空了... 崩溃！

我尝试过的方案

按照官方文档实现了SearchView的OnQueryTextListener
试过不同的过滤方法（filter、filterList）
检查了Adapter的notifyDataSetChanged()调用
甚至重写了三次Adapter类... 还是不行！

我的代码现状

这是我的MainActivity部分（简化版）：

// 搜索相关代码
searchView.setOnQueryTextListener(object : SearchView.OnQueryTextListener {
    override fun onQueryTextSubmit(query: String?): Boolean {
        return false
    }

    override fun onQueryTextChange(newText: String?): Boolean {
        filterList(newText)  // 这里调用了过滤方法
        return true
    }
})

// 过滤方法 - 感觉这里有问题但不知道在哪 😵
private fun filterList(query: String?) {
    if (query != null) {
        val filteredList = arrayList // 这里是不是有问题？
        for (i in mList) {
            if (i.contname.lowercase(Locale.ROOT).contains(query)) {
                filteredList.add(i)
            }
        }
        if (filteredList.isEmpty()){
            Toast.makeText(this,"No Contact found!", Toast.LENGTH_SHORT).show()               
        }else{
            adapter.setFilteredList(arrayList) // 这里传的参数对么？
        }
    }
}

这是我的Adapter关键部分：

// Adapter中的过滤方法
fun setFilteredList(contactList: List<ContactModel>){
    this.contactList = contactList as ArrayList<ContactModel>  // 这样转换安全吗？
    notifyDataSetChanged()  // 这个应该会刷新视图对吧？
}

具体症状

输入文字时列表没反应
有时候列表会突然清空
找不到匹配项时Toast也不显示
感觉过滤逻辑根本没起作用

我需要的帮助

我的过滤方法哪里写错了？
为什么notifyDataSetChanged()没效果？
有没有更简单的实现搜索的方法？
是不是我漏掉了什么基础知识？

PS: 从VB转Kotlin真的有点痛苦，但我会坚持下去的 💪 求各位Android大佬救救孩子！

1 Answers

开

开发者老刘

6/27/2025

Best Answer9

Answer #1 - Best Answer

嘿，朋友！👋 看到你的问题我完全感同身受 - 我刚开始用Kotlin做RecyclerView搜索时也经历过同样的崩溃时刻，甚至把键盘都拍坏了一个（开玩笑的 😅）。从VB转Kotlin确实需要适应期，但别担心，你的问题其实很常见，而且解决起来比你想的简单！

🔍 问题出在哪？

我看了你的代码，主要问题出在过滤逻辑和列表处理上。让我用"VB式思维"帮你解释：

列表引用问题：你的filteredList直接指向了原始列表（arrayList），这就像在VB中直接修改了原数据集 - 大忌啊！
过滤逻辑缺陷：没有清空临时列表，导致结果叠加
参数传递错误：把原始列表传回了adapter而不是过滤后的列表

💡 修复方案

这是我常用的可靠模式，加了些"人类注释"帮你理解：

// 更安全的过滤方法 - 带防呆设计
private fun filterList(query: String?) {
    val filteredList = ArrayList<ContactModel>() // 新建临时列表！重要！
    
    query?.let { // Kotlin的安全调用超好用
        if (it.isEmpty()) {
            // 搜索框为空时显示完整列表
            adapter.setFilteredList(mList) 
            return
        }
        
        // 遍历+过滤（注意大小写处理）
        for (contact in mList) {
            if (contact.contname.lowercase(Locale.ROOT)
                .contains(it.lowercase(Locale.ROOT))) {
                filteredList.add(contact)
            }
        }
        
        // 结果处理
        if (filteredList.isEmpty()) {
            Toast.makeText(this, "No matches found 😢", Toast.LENGTH_SHORT).show()
        }
        adapter.setFilteredList(filteredList) // 传过滤后的列表！
    } ?: run {
        // query为null时的处理（比如搜索框被清空）
        adapter.setFilteredList(mList)
    }
}

🛠 Adapter调整建议

// 更安全的Adapter方法
fun setFilteredList(filteredList: List<ContactModel>) {
    this.contactList.clear() // 先清空
    this.contactList.addAll(filteredList) // 再添加
    notifyDataSetChanged() // 最后刷新 - 这个顺序很重要！
}

💡 来自老司机的建议

调试技巧：在filterList里加Log打印，看看实际过滤出了什么
性能优化：数据量大时考虑用Filterable接口
常见坑：
- 忘记处理大小写（新手必踩坑）
- 直接修改原始列表（你现在的问题）
- 没处理空查询情况

🚀 更简单的替代方案

如果你想要更现代的解决方案，可以试试：

// 使用Kotlin的filter函数
val filtered = mList.filter { 
    it.contname.contains(query, ignoreCase = true) 
}

鼓励时间！

你已经做得很棒了！从VB转Kotlin就像从自行车换到摩托车 - 一开始不习惯，但一旦掌握就会发现它更强大！你的问题其实只是几个小细节，修复后就能完美运行了。

如果还有问题随时问我（我手机24小时开着就为了救急这种bug 😉）。记得在实现后给自己一个小奖励 - 你值得拥有！🎉

PS：下次遇到问题可以试试在log里打印关键变量，80%的问题这样就能发现原因。Keep coding! 💻✨

CloudFog API Gateway