Cordova应用（iOS/Android）Cookie未设置问题排查与解决求助

一、调试方法（确认Cookie是否未设置） #

1. 前端InAppBrowser调试 #

• 利用cordova-plugin-inappbrowser的loadstop事件注入JS，直接读取当前Cookie：

  const ref = cordova.InAppBrowser.open('local/index.html', '_self');
  ref.addEventListener('loadstop', () => {
    ref.executeScript({ code: "document.cookie" }, (values) => {
      console.log('当前所有Cookie:', values[0]);
      // 精准查找RememberMe Cookie
      const rememberMeCookie = values[0].split('; ').find(row => row.startsWith('RememberMe='))?.split('=')[1];
      console.log('RememberMe Cookie值:', rememberMeCookie || '未找到');
    });
  });
  

• 开启WebView调试：
  • Android：在config.xml添加<preference name="WebViewDebugging" value="true" />，用Chrome DevTools的Application > Cookies面板查看存储。
  • iOS：在Xcode中开启调试，用Safari开发工具的Storage > Cookies面板查看。

2. 后端Lucee调试 #

• 在设置Cookie的代码后，立即输出响应头，确认Cookie是否正确发送：

  <cfcookie samesite="strict"
            name="RememberMe"
            value="#strRememberMe#"
            expires="never"
            httponly="true" secure="true"
            />
  <!--- 调试用，上线前删除 --->
  <cfdump var="#getHTTPRequestData().responseHeader#" label="响应头信息">
  

• 检查服务器日志，确认登录请求的响应头中是否包含Set-Cookie: RememberMe=xxx; ...，同时验证请求的Origin、Referer是否符合Cookie的域规则。

3. 平台特定调试 #

• Android：检查AndroidManifest.xml中android:usesCleartextTraffic是否为false（HTTPS场景无需修改），同时确认cordova-plugin-inappbrowser的设置允许Cookie存储。
• iOS：检查config.xml中AllowFileAccessFromFileURLs、AllowUniversalAccessFromFileURLs是否开启，因为从file://协议跳转HTTPS属于跨域，需开启权限才能正常存储Cookie。

二、修复方案与解决建议 #

1. 调整Cookie属性配置 #

• 跨域场景下，SameSite设为None且必须保留Secure（SameSite=None强制要求HTTPS），同时明确指定domain属性：

  <cfcookie samesite="none"
            name="RememberMe"
            value="#strRememberMe#"
            domain=".example.com" <!--- 适配主域及子域 --->
            expires="#dateAdd('yyyy', 1, now())#" <!--- 替换never为具体过期时间，避免会话Cookie --->
            httponly="true" secure="true"
            />
  

• 避免使用expires="never"，不同平台对其解析可能存在差异，改为具体的过期日期（如1年后）。

2. 优化Cordova WebView设置 #

• Android：在config.xml添加以下配置，确保InAppBrowser允许存储和跨域访问：

  <preference name="AndroidInAppBrowserSettings" value="domstorage=yes,allowFileAccess=yes,allowUniversalAccessFromFileURLs=yes,thirdpartycookies=yes" />
  <preference name="WebViewStorageEnabled" value="true" />
  

• iOS：在config.xml添加以下配置，适配iOS 14+的跨域Cookie规则：

  <preference name="AllowFileAccessFromFileURLs" value="true" />
  <preference name="AllowUniversalAccessFromFileURLs" value="true" />
  <preference name="iosInAppBrowserOptions" value="allowFileAccess=yes,domStorageEnabled=yes" />
  

3. 简化跳转逻辑，避免跨域层级 #

将从本地file://页面跳转的逻辑改为直接用InAppBrowser打开HTTPS目标链接，减少跨域场景：

const targetUrl = `https://example.com/index.cfm?app_token=${token}&model=${device.model}&platform=${device.platform}&manufacturer=${device.manufacturer}&version=${device.version}`;
cordova.InAppBrowser.open(targetUrl, '_blank', 'location=no');

这样WebView初始加载的就是同域HTTPS页面，Cookie存储更符合浏览器规则。

4. 升级或检查插件版本 #

确保cordova-plugin-inappbrowser为最新版本，新版本通常会适配最新的Android/iOS WebView Cookie政策。

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