安卓webview如何监听返回键

在 Android WebView 中，“监听返回键”通常有两种场景：

1. 监听手机物理返回键（Activity 返回键）
2. 监听网页内部的返回（如 H5 路由返回）

下面分别说明。

一、监听 Android 物理返回键（Activity 返回键）

方式一：重写 onBackPressed()（推荐，简单）

@Override
public void onBackPressed() {
    if (webView.canGoBack()) {
        webView.goBack(); // 网页内返回
    } else {
        super.onBackPressed(); // 退出 Activity
    }
}

✅ 适用于大多数 WebView 应用

方式二：重写 dispatchKeyEvent（更底层）

@Override
public boolean dispatchKeyEvent(KeyEvent event) {
    if (event.getKeyCode() == KeyEvent.KEYCODE_BACK
            && event.getAction() == KeyEvent.ACTION_DOWN) {
        if (webView.canGoBack()) {
            webView.goBack();
            return true;
        }
    }
    return super.dispatchKeyEvent(event);
}

二、网页内部“返回键”逻辑（H5 控制）

1️⃣ H5 自己监听（推荐）

前端 JS 监听：

window.addEventListener("popstate", function () {
    // 返回逻辑
});

或：

history.pushState(null, null, location.href);
window.onpopstate = function () {
    // 返回操作
};

2️⃣ Android 与 H5 通信（JS Bridge）

Android 端：

webView.addJavascriptInterface(new Object() {
    @JavascriptInterface
    public void onBack() {
        // 处理返回
    }
}, "Android");

H5 端：

window.Android.onBack();

三、常见坑点 ⚠️

1. WebView 不自动处理返回
   • 必须手动 canGoBack() + goBack()
2. 返回键直接退出 App
   • 没判断 canGoBack()
3. H5 路由返回失效
   • 没使用 history.pushState

四、完整示例（最常用）

public class WebActivity extends AppCompatActivity {
    private WebView webView;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_web);

        webView = findViewById(R.id.webView);
        webView.setWebViewClient(new WebViewClient());
        webView.loadUrl("https://example.com");
    }

    @Override
    public void onBackPressed() {
        if (webView.canGoBack()) {
            webView.goBack();
        } else {
            super.onBackPressed();
        }
    }
}

如果你是指 “H5 页面里点击返回按钮”、“AndroidX 返回手势”、或者 “Flutter WebView / React Native WebView”，可以告诉我，我给你对应方案。