子域名嵌入iframe时WooCommerce购物车无法保存商品数据的修复方案

该故障由跨iframe场景下的会话Cookie拦截导致：

• new.example.com页通过iframe加载example.com的WooCommerce站点时，浏览器会将iframe内的所有请求判定为第三方上下文
• WooCommerce购物车状态完全依赖会话Cookie维持，WordPress默认生成的Cookie没有适配跨子域第三方上下文的传递规则，加购动作触发的Cookie写入被浏览器拦截，跳转购物车页时无法读取之前的加购会话，就会出现加购提示成功但购物车为空的现象
• 部分场景会叠加Cookie域名配置错误、缓存插件/CDN拦截会话Cookie的问题，进一步加剧故障

• 配置WordPress全局Cookie规则
  编辑WordPress根目录的wp-config.php文件，在/* That's all, stop editing! Happy publishing. */注释行之前添加如下配置：

  // 配置Cookie支持所有example.com下的子域共享
  define('COOKIE_DOMAIN', '.example.com');
  define('COOKIEPATH', '/');
  define('SITECOOKIEPATH', '/');
  
  // 调整会话Cookie的跨域传递规则
  add_action('init', function() {
      $is_https = isset($_SERVER['HTTPS']) && $_SERVER['HTTPS'] === 'on';
      @ini_set('session.cookie_samesite', $is_https ? 'None' : 'Lax');
      @ini_set('session.cookie_secure', $is_https ? 'On' : 'Off');
  }, 1);
  

  注意：SameSite属性值为None时必须同时开启HTTPS（即Cookie带Secure标记），否则Chrome、Edge等浏览器会直接拦截该Cookie，无HTTPS的测试环境可临时用Lax模式，正式环境请务必配置SSL证书。

• 调整WooCommerce会话Cookie属性
  将如下代码添加到当前使用主题的functions.php文件末尾（建议使用子主题添加，避免主题升级覆盖配置）：

  // 修正WooCommerce购物车会话Cookie属性
  add_filter('woocommerce_cookie_samesite', function() {
      $is_https = isset($_SERVER['HTTPS']) && $_SERVER['HTTPS'] === 'on';
      return $is_https ? 'None' : 'Lax';
  });
  add_filter('wc_session_cookie_secure', function($secure_flag) {
      return isset($_SERVER['HTTPS']) && $_SERVER['HTTPS'] === 'on';
  });
  

• 排查缓存类配置拦截

  • 若站点安装了页面缓存插件（如WP Rocket、W3 Total Cache、WP Super Cache等），需要将woocommerce_cart_hash、woocommerce_items_in_cart、wp_woocommerce_session_*加入Cookie排除列表，不对带这些Cookie的请求做静态缓存
  • 若站点接入了CDN服务，需要在CDN配置中开启上述会话Cookie的透传，禁止边缘节点剥离这类Cookie

• 兼容Safari浏览器配置
  Safari默认开启「阻止跨站跟踪」会额外拦截第三方iframe的Cookie，可在wp-config.php文件顶部（<?php行之后）添加如下头配置解决：

  header('P3P: CP="NOI ADM DEV PSAi COM NAV OUR OTRo STP IND DEM"');
  

所有配置完成后，清空浏览器缓存、WordPress站点缓存、CDN缓存，重新打开嵌入页测试：

1. 加购商品后打开浏览器开发者工具，切换到「应用-Cookie」面板，选中example.com域，检查WooCommerce会话Cookie的Domain值为.example.com、SameSite属性与HTTPS状态匹配
2. Cookie正常写入后，跳转购物车页面即可正常读取加购的商品数据

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