Android开发：AppBar中无法显示菜单搜索图标问题求助

云原生阿岚

2026-10-13

搜索图标无法显示的常见原因及解决方案

1. 主题未携带ActionBar导致无法挂载菜单

这是最高发的问题：如果你的Activity使用的是无ActionBar的主题（比如Theme.MaterialComponents.DayNight.NoActionBar），系统不会自动生成ActionBar承载菜单，搜索图标自然无法渲染。
解决方法：

方案1：修改AndroidManifest.xml中对应Activity的主题，替换为带ActionBar的主题，例如Theme.MaterialComponents.DayNight.DarkActionBar
方案2：如果需要使用无ActionBar主题，在布局文件中手动添加Toolbar控件，之后在onCreate方法中调用setSupportActionBar(binding.你的Toolbar控件ID)完成关联。

2. SearchView配置冲突

你同时配置了app:actionViewClass和android:icon，部分系统版本下SearchView的默认渲染逻辑会覆盖图标配置。
解决方法：
先调整menu配置，增加图标着色适配主题，同时修正showAsAction属性适配折叠逻辑：

<item
    android:id="@+id/search"
    android:icon="@drawable/ic_search"
    android:title="搜索"
    app:showAsAction="ifRoom|collapseActionView"
    app:actionViewClass="androidx.appcompat.widget.SearchView"
    android:iconTint="?attr/colorOnPrimary"/>

如果还是不显示，可以在onCreateOptionsMenu中手动配置SearchView属性：

override fun onCreateOptionsMenu(menu: Menu?): Boolean {
    menuInflater.inflate(R.menu.menu,menu)
    val searchItem = menu?.findItem(R.id.search)
    val searchView = searchItem?.actionView as androidx.appcompat.widget.SearchView
    searchView.setIconifiedByDefault(true)
    return true
}