Android真机测试时SearchView键盘搜索异常问题求助

测试表现 #

虚拟设备（Pixel 3 API 31，Android Studio Chipmunk） #

• 行为1：通过键盘输入并按下操作键，可正常提交搜索查询、执行搜索并返回结果。
  
• 行为2：点击自动补全建议后按下键盘搜索键，可正常执行搜索。
  

OPPO Reno 5G真机（API级别31） #

• 仅行为1表现正常
• 行为2无结果返回，但应用未崩溃
• 唯一差异：OPPO真机键盘会显示数字键行

相关配置代码 #

AndroidManifest中的Activity配置 #

<activity
    android:name=".MainActivity"
    android:exported="true"
    android:launchMode="singleInstance">
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />

        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>

    <meta-data android:name="android.app.searchable"
        android:resource="@xml/searchable"/>

</activity>

可搜索配置（@xml/searchable） #

<?xml version="1.0" encoding="utf-8"?>
<searchable xmlns:android="http://schemas.android.com/apk/res/android"
    android:label="@string/app_name"
    android:hint="search food name">

</searchable>

应用菜单XML定义（@menu/appbar_menu） #

<?xml version="1.0" encoding="utf-8"?>
<menu xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto">

    <item
        android:id="@+id/search_box"
        android:icon="@drawable/ic_outline_search_24"
        android:title="Search"
        app:actionViewClass="android.widget.SearchView"
        app:showAsAction="ifRoom|withText" />
</menu>

MainActivity中搜索功能实现 #

@Override
public boolean onCreateOptionsMenu(Menu menu) {
    MenuInflater inflater = getMenuInflater();
    inflater.inflate(R.menu.appbar_menu, menu);

    // 关联可搜索配置与SearchView
    SearchManager searchManager = (SearchManager) getSystemService(Context.SEARCH_SERVICE);
    SearchView searchView = (SearchView) menu.findItem(R.id.search_box).getActionView();
    MenuItem searchMenuItem = menu.findItem(R.id.search_box);

    searchView.setSearchableInfo(searchManager.getSearchableInfo(getComponentName()));

    searchView.setOnQueryTextListener(new SearchView.OnQueryTextListener() {
        @Override
        public boolean onQueryTextSubmit(String s) {
            doSearch(s);
            hideKeyboard(MainActivity.this);
            return false;
        }

        @Override
        public boolean onQueryTextChange(String s) {
            return false;
        }
    });

return super.onCreateOptionsMenu(menu);
}

排查建议 #

1. 确认onQueryTextSubmit触发状态：在该方法内添加日志，检查OPPO真机上点击自动补全建议后，是否接收到查询文本。
2. 校验查询文本格式：打印s.trim()后的内容，排查是否因厂商键盘添加不可见字符导致搜索无匹配。
3. 修改onQueryTextSubmit返回值：将return false改为return true，避免系统默认动作干扰自定义搜索逻辑。
4. 暂时注释hideKeyboard方法：验证是否是键盘隐藏逻辑提前中断了搜索请求。

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