Android（CapacitorJS 4）WebView中启用Cookie的方法

针对你遇到的Android端Cookie无法自动设置、授权失败的问题，以下是针对性的解决步骤：

1. 配置Capacitor WebView参数 #

在项目根目录的capacitor.config.ts（或capacitor.config.json）中添加Android WebView的专属配置，确保WebView具备Cookie存储和跨域访问权限：

import { CapacitorConfig } from '@capacitor/cli';

const config: CapacitorConfig = {
  appId: 'com.your.app.id',
  appName: 'YourAppName',
  webDir: 'dist',
  server: {
    androidScheme: 'https' // 优先使用HTTPS，避免明文流量限制
  },
  android: {
    webViewSettings: {
      allowFileAccess: true,
      allowContentAccess: true,
      // 根据实际场景选择混合内容模式：0=允许所有，2=仅允许HTTPS（推荐）
      mixedContentMode: 2,
      allowFileAccessFromFileURLs: true,
      allowUniversalAccessFromFileURLs: true
    }
  }
};

export default config;

2. 修正Android原生Cookie配置 #

在MainActivity.java中补充完整的CookieManager初始化逻辑，重点针对Android 11+（API 30及以上）开启第三方Cookie支持：

import android.os.Bundle;
import android.webkit.CookieManager;
import com.getcapacitor.BridgeActivity;

public class MainActivity extends BridgeActivity {
  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    
    // 必须在WebView初始化前配置CookieManager
    CookieManager cookieManager = CookieManager.getInstance();
    cookieManager.setAcceptCookie(true);
    
    // Android 11+ 强制要求显式开启第三方Cookie
    if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.R) {
      cookieManager.setAcceptThirdPartyCookies(getWebView(), true);
    }
    
    // 为跨域Cookie设置必要属性（HTTPS环境下生效）
    cookieManager.setCookie("your-api-domain.com", "SameSite=None; Secure");
  }
}

3. 确认Axios配置正确性 #

确保全局或单个请求启用withCredentials，让Axios自动携带和存储Cookie：

import axios from 'axios';

// 全局配置（推荐）
axios.defaults.withCredentials = true;

// 单个请求配置（可选）
axios.post('https://your-api-domain.com/login', {
  username: 'xxx',
  password: 'xxx'
}, {
  withCredentials: true
}).then(res => {
  // 后续请求会自动携带授权Cookie
  return axios.get('https://your-api-domain.com/user/profile');
});

4. 额外配置（若使用HTTP请求） #

Android 12默认禁止明文HTTP流量，若必须使用HTTP接口，需添加以下配置：

1. 在res/xml目录下创建network_security_config.xml：

<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
    <domain-config cleartextTrafficPermitted="true">
        <domain includeSubdomains="true">your-http-api-domain.com</domain>
    </domain-config>
</network-security-config>

2. 在AndroidManifest.xml的application标签中引用该配置：

<application
    ...
    android:networkSecurityConfig="@xml/network_security_config">
</application>

关键注意事项 #

• API接口的响应Cookie必须携带SameSite=None; Secure属性（HTTPS环境），否则Android 12会拒绝存储跨域Cookie。
• 确保CapacitorJS 4为最新版本，避免旧版本的WebView Cookie处理bug。

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