Android开发：如何仅在用户最后一次输入500ms后提交搜索内容？

你当前的问题是每次输入字符都会提交新的延迟任务，旧任务没有被取消，导致多次触发操作，属于典型的输入防抖需求，修改后代码如下：

private val delay = 500L //ms
private val handler = Handler(Looper.getMainLooper())
// 缓存待执行的搜索任务，用于后续取消
private var searchRunnable: Runnable? = null

binding.searchView.setOnQueryTextListener(object : SearchView.OnQueryTextListener {
        override fun onQueryTextSubmit(text: String?): Boolean {
            // 可选：点击提交按钮直接触发搜索
            text?.let { doSearch(it) }
            return true
        }

        override fun onQueryTextChange(newText: String?): Boolean {
            // 先取消上一次还没执行的搜索任务
            searchRunnable?.let { handler.removeCallbacks(it) }
            
            // 生成新的搜索任务
            searchRunnable = Runnable {
                newText?.takeIf { it.isNotBlank() }?.let {
                    doSearch(it)
                }
            }
            // 提交新的延迟任务
            searchRunnable?.let { handler.postDelayed(it, delay) }
            return false
        }
    })

// 统一封装搜索逻辑
private fun doSearch(keyword: String) {
    Log.d("SEARCH", "Searching for: $keyword")
    // 此处替换为实际的搜索请求业务逻辑
}

核心修改说明 #

• 新增searchRunnable成员变量缓存待执行的搜索任务，解决每次生成新Runnable无法取消旧任务的问题
• 每次文本变更时，先移除队列中未执行的旧搜索任务，再提交新的延迟任务
• 只有最后一次输入后满500ms没有新输入，任务才会正常执行，完全符合需求
• 增加空字符串判断，避免用户清空输入时触发无效搜索

注意事项 #

页面销毁时需要清空任务队列，避免内存泄漏：

override fun onDestroy() {
    super.onDestroy()
    // 移除所有待执行任务
    handler.removeCallbacksAndMessages(null)
}

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