Android Fragment中Material SearchView的OnQueryTextListener失效问题

我帮你梳理下大概率遗漏的配置点，按步骤排查应该就能解决监听没触发的问题：

1. 必须开启Fragment的菜单支持 #

这是最容易忽略的关键步骤！在Fragment的onCreate方法里，一定要调用setHasOptionsMenu(true)，告诉系统这个Fragment需要参与菜单的创建流程，否则onCreateOptionsMenu方法根本不会被执行：

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setHasOptionsMenu(true) // 核心：开启Fragment菜单权限
}

2. 正确获取并配置SearchView #

你使用的是androidx.appcompat.widget.SearchView，要确保转型正确，同时避免在inflater之后调用super的顺序问题：

override fun onCreateOptionsMenu(menu: Menu, inflater: MenuInflater) {
    inflater.inflate(R.menu.menu_search, menu)
    
    // 从菜单中获取搜索项并转型为正确的SearchView
    val searchMenuItem = menu.findItem(R.id.action_search)
    val searchView = searchMenuItem.actionView as androidx.appcompat.widget.SearchView

    // 设置监听逻辑
    searchView.setOnQueryTextListener(object : androidx.appcompat.widget.SearchView.OnQueryTextListener {
        override fun onQueryTextSubmit(query: String?): Boolean {
            Timber.d("搜索提交内容：$query")
            searchView.clearFocus() // 可选：提交后收起键盘
            return true
        }

        override fun onQueryTextChange(newText: String?): Boolean {
            Timber.d("输入内容变化：$newText")
            return true
        }
    })
    
    super.onCreateOptionsMenu(menu, inflater)
}

3. 验证Toolbar与Activity的关联（可选但重要） #

如果你的宿主Activity没有把MaterialToolbar设置为默认ActionBar，可能会导致Fragment菜单无法正确绑定到Toolbar上，在Activity的onCreate中添加：

val toolbar = findViewById<MaterialToolbar>(R.id.toolbar)
setSupportActionBar(toolbar)

如果不需要ActionBar的其他功能，这一步也能保证Fragment的菜单被正确渲染到Toolbar。

4. 检查Timber的初始化状态 #

有时候不是监听没触发，而是Timber没初始化导致日志没输出。在你的Application类里确认是否初始化了Timber：

class MyApplication : Application() {
    override fun onCreate() {
        super.onCreate()
        if (BuildConfig.DEBUG) {
            Timber.plant(Timber.DebugTree())
        }
    }
}

如果暂时不想配置Timber，可以先用Log.d("SearchDebug", "测试日志")替代，确认是否有输出。

补充：无需重写onOptionsItemSelected #

你提到没重写这个方法是没问题的，SearchView的OnQueryTextListener不需要依赖这个方法就能工作，不用额外添加。

按上面的步骤逐一排查，应该就能解决监听无响应的问题了！

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