React Native Webview Android端document.cookie为空问题求助

我之前在项目里也踩过Android WebView Cookie的坑，结合你的代码和实际排查经验，给你几个可行的解决方向：

1. 优先检查服务端Cookie的SameSite与Secure属性 #

Android WebView（基于Chrome内核）对跨站Cookie的限制比iOS严格很多：

• 如果你的Cookie设置了SameSite=None，必须同时加上Secure属性（你的站点是HTTPS，完全符合要求），否则Android会直接拒绝存储这个Cookie。
• 可以让后端同事检查响应头里的Set-Cookie字段，确保格式类似：CookieName=CookieValue; SameSite=None; Secure; Path=/

2. 补充WebView的Cookie相关配置 #

虽然你已经开启了thirdPartyCookiesEnabled={true}，但Android上还可以尝试补充这些配置：

• 添加allowFileAccess={true}（部分场景下会间接影响Cookie读取逻辑）
• 尝试设置userAgent为移动端Chrome的UA，模拟原生浏览器环境：

  userAgent="Mozilla/5.0 (Linux; Android 10; SM-G973F) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Mobile Safari/537.36"
  

3. 调试Cookie的存储状态 #

用Chrome远程调试工具直接查看WebView的Cookie情况：

1. 打开Chrome浏览器，输入chrome://inspect
2. 连接你的Android设备，找到对应的WebView实例
3. 在调试面板的Application > Cookies下，查看目标站点是否有存储Cookie：
   • 如果没有Cookie：说明服务端的Set-Cookie头不符合Android要求，回到第一步排查
   • 如果有Cookie但JS拿不到：可能是页面JS的执行时机问题，或者WebView的JS上下文限制

4. 手动注入JS验证Cookie读取 #

可以在WebView加载完成后，手动注入JS来测试Cookie是否能被读取，排除页面自身JS的问题：

import { useRef } from 'react';
import { WebView } from 'react-native-webview';

// ...
const webViewRef = useRef(null);

return (
  <View style={styles.container}>
    <WebView
      ref={webViewRef}
      javaScriptEnabled={true}
      domStorageEnabled={true}
      thirdPartyCookiesEnabled={true}
      allowUniversalAccessFromFileURLs={true}
      mixedContentMode={'always'}
      source={{uri:"https://mywebsite.com/"}}
      onLoad={() => {
        webViewRef.current?.injectJavaScript(`
          const cookie = document.cookie;
          console.log('Debug Cookie:', cookie);
          window.ReactNativeWebView.postMessage(cookie);
        `);
      }}
      onMessage={(event) => {
        console.log('WebView返回的Cookie:', event.nativeEvent.data);
      }}
    />
  </View>
);

如果这段注入的JS能拿到Cookie，那问题可能出在页面自身的JS逻辑上（比如执行时机过早）。

5. 考虑Android系统版本差异 #

Android 10及以上版本对第三方Cookie的限制更严格，如果你测试的设备是Android 10+，可以尝试在AndroidManifest.xml里添加：

<application android:allowBackup="true" ... android:usesCleartextTraffic="true">

不过你的站点是HTTPS，这个可能影响不大，但可以作为额外尝试。

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