Android简单WebView应用如何实现首次登录后自动登录

嘿，这个需求我之前做WebView项目的时候刚好踩过坑，其实核心就是正确持久化并复用登录相关的Cookie，我给你拆解下具体实现步骤，分Android和iOS两种常见的客户端情况来说明：

• 第一步：开启WebView的Cookie支持
  初始化WebView时，必须先开启Cookie和相关存储权限，不然Cookie没法正常保存和读取：

  WebSettings webSettings = webView.getSettings();
  webSettings.setJavaScriptEnabled(true); // 很多网站依赖JS，建议开启
  webSettings.setDomStorageEnabled(true); // 支持localStorage，部分网站会用它存登录状态
  webSettings.setAcceptCookie(true); // 允许WebView接收Cookie
  

• 第二步：登录成功后保存Cookie
  在用户完成登录、WebView加载完登录后的页面时，我们可以通过CookieManager获取当前域名下的所有Cookie，然后存到本地存储（比如SharedPreferences）：

  // 在WebView的onPageFinished回调中执行
  @Override
  public void onPageFinished(WebView view, String url) {
      super.onPageFinished(view, url);
      // 替换成你的目标网站域名
      String targetDomain = "https://your-website.com";
      CookieManager cookieManager = CookieManager.getInstance();
      String cookieStr = cookieManager.getCookie(targetDomain);
      
      // 保存到SharedPreferences
      SharedPreferences sp = getSharedPreferences("WebViewLoginData", MODE_PRIVATE);
      sp.edit().putString("login_cookie", cookieStr).apply();
  }
  

• 第三步：启动App时恢复Cookie
  下次打开App、初始化WebView之后，加载网页之前，把本地保存的Cookie重新注入到WebView中：

  String targetDomain = "https://your-website.com";
  SharedPreferences sp = getSharedPreferences("WebViewLoginData", MODE_PRIVATE);
  String savedCookie = sp.getString("login_cookie", null);
  
  if (savedCookie != null) {
      CookieManager cookieManager = CookieManager.getInstance();
      cookieManager.setCookie(targetDomain, savedCookie);
      
      // 针对不同Android版本的Cookie同步处理
      if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
          cookieManager.flush(); // 5.0+直接flush
      } else {
          CookieSyncManager.createInstance(this);
          CookieSyncManager.getInstance().sync(); // 5.0以下需要同步
      }
  }
  
  // 直接加载登录后的页面，就能保持登录状态了
  webView.loadUrl(targetDomain + "/dashboard");
  

如果是iOS的WKWebView，实现思路类似，只是API不同：

• 第一步：初始化WKWebView时配置基础设置
  WKWebView默认会处理Cookie，但我们可以确保配置正确：

  let webConfig = WKWebViewConfiguration()
  // 用全局的ProcessPool可以让多个WebView共享Cookie，可选
  webConfig.processPool = WKProcessPool()
  let webView = WKWebView(frame: view.bounds, configuration: webConfig)
  view.addSubview(webView)
  

• 第二步：登录后保存Cookie到UserDefaults
  登录完成后，从系统的HTTPCookieStorage中取出对应域名的Cookie，归档后保存：

  guard let targetUrl = URL(string: "https://your-website.com") else { return }
  if let cookies = HTTPCookieStorage.shared.cookies(for: targetUrl) {
      do {
          let cookieData = try NSKeyedArchiver.archivedData(withRootObject: cookies, requiringSecureCoding: false)
          UserDefaults.standard.set(cookieData, forKey: "WebViewLoginCookies")
      } catch {
          print("保存Cookie失败：\(error)")
      }
  }
  

• 第三步：启动时恢复Cookie
  加载网页前，把保存的Cookie恢复到HTTPCookieStorage：

  guard let targetUrl = URL(string: "https://your-website.com") else { return }
  if let cookieData = UserDefaults.standard.data(forKey: "WebViewLoginCookies"),
     let cookies = try? NSKeyedUnarchiver.unarchivedObject(ofClasses: [NSArray.self, HTTPCookie.self], from: cookieData) as? [HTTPCookie] {
      for cookie in cookies {
          HTTPCookieStorage.shared.setCookie(cookie)
      }
  }
  
  // 加载登录后的页面
  webView.load(URLRequest(url: targetUrl.appendingPathComponent("/dashboard")))
  

• 确认Cookie的持久化属性：如果后端返回的是会话Cookie（Session Cookie），这类Cookie在App关闭后会被系统清除，需要和后端配合，设置带有过期时间的持久化Cookie。
• 域名必须完全匹配：保存和注入Cookie时的域名，要和WebView加载的网页域名完全一致，不然Cookie不会生效。
• 部分网站用localStorage存登录状态：这种情况只要开启了WebView的DomStorage支持（Android的setDomStorageEnabled(true)，iOS默认支持），WebView会自动持久化localStorage数据，不用额外处理。

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