为何设置空WebViewClient会改变Android WebView的SharePoint登录行为？

一、默认WebViewClient与原生WebView行为的差异 #

当你没有手动设置WebViewClient时，WebView会使用系统内部的默认客户端实现，这个实现包含了针对企业级网站（如SharePoint）身份验证、重定向、Cookie管理的适配逻辑：

• 身份验证处理：默认客户端会自动处理HTTP身份验证请求（比如SharePoint登录流程中的ADFS验证），可能调用系统凭证弹窗或复用已有的系统登录会话；
• 重定向逻辑：对于登录流程中的OAuth跳转、域名重定向，默认客户端会允许WebView继续加载这些跳转链接，保证登录流程完整；
• Cookie与会话共享：默认客户端会正确处理SharePoint设置的会话Cookie，确保登录状态能被持久化和传递。

而你手动创建的new WebViewClient()是一个空实现的基类，它的部分关键方法（如onReceivedHttpAuthRequest）默认行为是拒绝或不处理这些关键流程，直接导致SharePoint的登录验证被阻断。

二、保留WebViewClient同时修复登录问题的方案 #

你需要继承WebViewClient并重写关键方法，让它们的行为贴合系统默认逻辑，同时保留自定义扩展能力：

1. 处理URL重定向 #

重写shouldOverrideUrlLoading方法，允许登录相关的跳转：

webView.setWebViewClient(new WebViewClient() {
    @Override
    public boolean shouldOverrideUrlLoading(WebView view, WebResourceRequest request) {
        view.loadUrl(request.getUrl().toString());
        return true;
    }

    // 兼容API 24以下版本
    @Override
    public boolean shouldOverrideUrlLoading(WebView view, String url) {
        view.loadUrl(url);
        return true;
    }
});

2. 处理HTTP身份验证请求 #

如果SharePoint使用HTTP认证，重写该方法调用系统默认处理：

@Override
public void onReceivedHttpAuthRequest(WebView view, HttpAuthHandler handler, String host, String realm) {
    handler.proceed();
}

3. 确保Cookie正常工作 #

初始化WebView时开启Cookie支持，适配跨域登录场景：

CookieManager cookieManager = CookieManager.getInstance();
cookieManager.setAcceptCookie(true);
// Android 5.0及以上允许第三方Cookie
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
    cookieManager.setAcceptThirdPartyCookies(webView, true);
}

完整适配后的代码示例 #

WebView webView = new WebView(this);
webView.setLayoutParams(new LinearLayout.LayoutParams(WindowManager.LayoutParams.MATCH_PARENT, WindowManager.LayoutParams.MATCH_PARENT));

WebSettings settings = webView.getSettings();
settings.setJavaScriptEnabled(true);
// 开启DOM存储，适配SharePoint前端需求
settings.setDomStorageEnabled(true);
settings.setDatabaseEnabled(true);

// 配置Cookie
CookieManager cookieManager = CookieManager.getInstance();
cookieManager.setAcceptCookie(true);
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
    cookieManager.setAcceptThirdPartyCookies(webView, true);
}

setContentView(webView);

webView.setWebViewClient(new WebViewClient() {
    @Override
    public boolean shouldOverrideUrlLoading(WebView view, WebResourceRequest request) {
        view.loadUrl(request.getUrl().toString());
        return true;
    }

    @Override
    public boolean shouldOverrideUrlLoading(WebView view, String url) {
        view.loadUrl(url);
        return true;
    }

    @Override
    public void onReceivedHttpAuthRequest(WebView view, HttpAuthHandler handler, String host, String realm) {
        handler.proceed();
    }
});

webView.loadUrl("https://eponalabs.sharepoint.com");

关键说明 #

• 开启DomStorageEnabled是因为SharePoint前端依赖DOM存储保存登录状态数据；
• 允许第三方Cookie是因为SharePoint登录流程可能跳转到微软身份验证域名，需要跨域传递Cookie；
• 重写的方法既贴合系统默认行为，又给你留下了添加自定义资源加载/分析逻辑的空间（比如在shouldOverrideUrlLoading中记录URL日志）。

内容的提问来源于stack exchange，提问作者Paul-Jan