Android返回键按下时SearchView值失效导致搜索结果异常问题

这个问题我之前帮好几个开发者排查过，核心原因很明确：你的Fragment只在UI层面保留了SearchView的文本，但没有在生命周期中保存搜索状态，导致返回后数据加载逻辑又默认拉取了全部客户数据。下面是一步步的修复方案：

1. 把搜索关键词存进Fragment的状态里 #

Fragment在从后台返回时，可能会经历重建（比如配置变化或者内存回收），所以我们需要把当前的搜索关键词持久化到Bundle中：

// 在Fragment类里定义一个变量保存当前搜索词
private var currentSearchQuery: String = ""

// 保存状态
override fun onSaveInstanceState(outState: Bundle) {
    super.onSaveInstanceState(outState)
    outState.putString("SEARCH_QUERY_KEY", currentSearchQuery)
}

// 恢复状态
override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
    super.onViewCreated(view, savedInstanceState)
    
    savedInstanceState?.let { savedState ->
        // 取出之前保存的搜索词
        currentSearchQuery = savedState.getString("SEARCH_QUERY_KEY", "")
        // 同步SearchView的文本（如果你的UI已经保留了，这步可以省略，但加了更保险）
        binding.searchView.setQuery(currentSearchQuery, false)
        // 直接用恢复的关键词重新加载筛选后的数据
        loadFilteredCustomers(currentSearchQuery)
    } ?: run {
        // 首次加载，显示全部数据
        loadAllCustomers()
    }
}

2. 同步SearchView输入和搜索状态 #

每次用户在SearchView里输入或提交搜索时，都要更新我们的currentSearchQuery变量，确保状态和UI一致：

binding.searchView.setOnQueryTextListener(object : SearchView.OnQueryTextListener {
    override fun onQueryTextSubmit(query: String?): Boolean {
        query?.trim()?.let {
            currentSearchQuery = it
            loadFilteredCustomers(it)
        }
        // 隐藏键盘，提升体验
        requireActivity().currentFocus?.let { view ->
            val imm = requireContext().getSystemService(Context.INPUT_METHOD_SERVICE) as InputMethodManager
            imm.hideSoftInputFromWindow(view.windowToken, 0)
        }
        return true
    }

    override fun onQueryTextChange(newText: String?): Boolean {
        newText?.trim()?.let {
            currentSearchQuery = it
            // 如果需要实时筛选（输入时就更新列表），就保留这行；如果只在提交时筛选，就删掉
            loadFilteredCustomers(it)
        }
        return true
    }
})

3. 修复onResume里的逻辑 #

很多开发者会在onResume里重新加载数据，这时候一定要判断当前有没有搜索词，别直接拉全部数据：

override fun onResume() {
    super.onResume()
    // 有搜索词就加载筛选结果，否则加载全部
    if (currentSearchQuery.isNotEmpty()) {
        loadFilteredCustomers(currentSearchQuery)
    } else {
        loadAllCustomers()
    }
}

4. 额外优化：避免重复请求 #

如果你的API请求是异步的，建议用Job管理请求，防止旧请求覆盖新的筛选结果（比如用户快速输入时）：

private var searchRequestJob: Job? = null

private fun loadFilteredCustomers(query: String) {
    // 取消之前的请求
    searchRequestJob?.cancel()
    searchRequestJob = lifecycleScope.launch {
        try {
            val filteredData = apiService.getCustomersByQuery(query)
            customerAdapter.submitList(filteredData)
        } catch (e: Exception) {
            // 处理请求失败的情况
            Log.e("CustomerFragment", "Load filtered customers failed", e)
        }
    }
}

这样改完之后，从详情页返回时，Fragment会自动用保存的搜索词重新加载筛选后的列表，和SearchView里的文本就完全匹配了。

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