Android Fragment中SearchView的QueryTextListener未触发问题求助

我之前也碰到过一模一样的情况！问题出在你同时给Toolbar自身和Fragment的Options Menu加载了同一个菜单，但这是两个完全独立的菜单实例——你给Fragment菜单里的SearchView绑定了监听，可界面上实际显示的是Toolbar自己创建的那个SearchView，所以回调自然不会被触发。

具体原因拆解 #

• 在onCreateView中调用contactsToolbar.inflateMenu(R.menu.contacts_menu)，会给Toolbar生成一个专属的本地菜单
• 同时在onCreateOptionsMenu里又通过inflater.inflate(R.menu.contacts_menu, menu)加载了Fragment的Options Menu，这是另一个独立的菜单对象
• 你把监听设置到了Fragment菜单的SearchView上，但用户交互的是Toolbar的SearchView，两者完全没关系

两种可行解决方案 #

方案一：关联Toolbar与ActionBar（推荐）

这种方式让Fragment的Options Menu和Toolbar绑定，统一管理菜单逻辑：

1. 删除onCreateView中的contactsToolbar.inflateMenu(R.menu.contacts_menu)代码
2. 将Toolbar设置为宿主Activity的ActionBar（确保你的Activity继承自AppCompatActivity）：

override fun onCreateView(
    inflater: LayoutInflater,
    container: ViewGroup?,
    savedInstanceState: Bundle?
): View? {
    val rootView = inflater.inflate(R.layout.fragment_contacts, container, false)
    setHasOptionsMenu(true)
    contactsToolbar = rootView.findViewById(R.id.contacts_toolbar)
    // 新增：绑定Toolbar到ActionBar
    (requireActivity() as AppCompatActivity).setSupportActionBar(contactsToolbar)
    contactsToolbar.title = "Contacts"
    // 其他逻辑...
    return rootView
}

3. 保留onCreateOptionsMenu中的原有代码不变，此时Fragment的Options Menu会自动显示在Toolbar上，监听也能正常触发

方案二：直接操作Toolbar的菜单

如果不想依赖ActionBar，可以直接给Toolbar的菜单设置监听：

1. 删除onCreateOptionsMenu中的所有代码（包括super.onCreateOptionsMenu(menu, inflater)）
2. 在onCreateView中，加载Toolbar菜单后直接获取并绑定监听：

override fun onCreateView(
    inflater: LayoutInflater,
    container: ViewGroup?,
    savedInstanceState: Bundle?
): View? {
    val rootView = inflater.inflate(R.layout.fragment_contacts, container, false)
    // 不需要再调用setHasOptionsMenu(true)
    contactsToolbar = rootView.findViewById(R.id.contacts_toolbar)
    contactsToolbar.inflateMenu(R.menu.contacts_menu)
    contactsToolbar.title = "Contacts"
    
    // 获取Toolbar菜单里的搜索项并设置监听
    val searchItem = contactsToolbar.menu.findItem(R.id.action_search)
    val searchView = searchItem.actionView as SearchView
    searchView.setOnQueryTextListener(object : SearchView.OnQueryTextListener {
        override fun onQueryTextSubmit(query: String?): Boolean {
            Log.d(TAG, "new query $query")
            return true
        }
        override fun onQueryTextChange(newText: String?): Boolean {
            Log.d(TAG, "new text $newText")
            return true
        }
    })
    
    // 其他逻辑...
    return rootView
}

额外注意 #

你的菜单文件中已经正确指定了app:actionViewClass="androidx.appcompat.widget.SearchView"，这部分没问题，确保代码中使用的也是androidx.appcompat.widget.SearchView而非原生的android.widget.SearchView即可。

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