Android WebView键盘聚焦时遮挡输入框问题求助

阿华AIGC实验室

2026-4-13

你好呀！这个WebView键盘遮挡输入框的问题我之前在项目里碰到过好多次，给你几个亲测有效的解决思路，适配Android 7及以上版本完全没问题：

1. 补全Activity的Manifest配置（关键第一步）

你贴的Manifest代码没写完，但首先要确保承载WebView的Activity，windowSoftInputMode必须设置正确——这是解决这类问题最基础也是最有效的一步。把对应Activity的配置改成这样：

<activity
    android:name=".你的WebView所在Activity"
    android:windowSoftInputMode="adjustResize|stateHidden">
    <!-- 你原本的其他配置（比如intent-filter之类的） -->
</activity>

这里的adjustResize是核心：它会让系统在键盘弹出时，自动调整Activity的布局大小，WebView作为布局的一部分会跟着向上偏移，输入框自然就不会被挡住了；stateHidden是让键盘默认不自动弹出，如果你需要默认弹出可以换成stateVisible，根据自己的需求调整就行。

2. 给WebView布局加适配属性

如果Manifest设置后还是偶尔出现遮挡，试试给WebView或者它的父布局加上这个属性：

android:fitsSystemWindows="true"

这个属性会让布局自动适配系统窗口的变化（比如键盘弹出、状态栏高度变化），能帮WebView更准确地响应布局调整。

3. 调整WebView的代码配置

有时候WebView的默认配置会影响滚动行为，你可以在代码里给WebView加上这些设置：

WebSettings webSettings = webView.getSettings();
// 开启JS支持（如果你的HTML页面需要的话）
webSettings.setJavaScriptEnabled(true);
// 开启内置缩放控件，确保页面可滚动调整
webSettings.setSupportZoom(true);
webSettings.setBuiltInZoomControls(true);
webSettings.setDisplayZoomControls(false);
// 让WebView获取焦点，确保输入框能正确触发键盘
webView.requestFocus(View.FOCUS_DOWN);

4. HTML页面侧的兜底方案

如果上面的Android原生配置都没解决，可能是你加载的HTML页面本身的视口或布局有问题：

先确保HTML的<head>里有正确的视口设置，适配手机屏幕：

<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no">

还可以加一段JS监听窗口变化，当输入框聚焦时自动滚动到可视区域：

window.addEventListener('resize', function() {
    const activeElement = document.activeElement;
    // 只处理输入框和文本域
    if (['INPUT', 'TEXTAREA'].includes(activeElement.tagName)) {
        // 延迟300ms是为了等键盘完全弹出后再滚动
        setTimeout(() => {
            activeElement.scrollIntoView({ behavior: 'smooth', block: 'center' });
        }, 300);
    }
});

这段JS会在键盘弹出（触发窗口resize事件）时，把当前聚焦的输入框滚动到屏幕中间，确保完全可见。

一般来说，只要把第一步的windowSoftInputMode设置对，90%的情况下问题就能解决了，后面的步骤可以作为兜底方案试试。

备注：内容来源于stack exchange，提问作者exejee