通过URL变量预填充WooCommerce结账字段仅硬刷新生效求助

首先，先看你代码里的一个明显笔误：你定义的函数是save()，但绑定到wp_enqueue_scripts钩子的却是save_email——这会导致处理GET参数、设置session的函数根本不会被执行！这很可能是问题的核心原因之一，硬刷新时可能因为缓存失效，某种巧合让代码临时生效，但正常情况下这个逻辑是跑不起来的。

接下来，我们拆解为什么只有硬刷新生效，以及完整的解决思路：

一、核心问题排查 #

1. 钩子时机与Session初始化问题 #

你用了wp_enqueue_scripts钩子来处理session设置，但这个钩子是在加载脚本的时候触发的，此时WooCommerce的Session可能还没完全初始化。当用户普通刷新时，浏览器可能复用了旧的session或者缓存的页面，导致session设置逻辑没执行；而硬刷新会强制浏览器重新请求，此时Session初始化流程完整，代码才偶然生效。

2. 浏览器/缓存服务的缓存规则 #

虽然你排除了销售页和结账页的缓存，但可能存在以下情况：

• 浏览器缓存：普通刷新时，浏览器加载了本地缓存的销售页，根本没把tu_em/tu_name参数传递到服务器；硬刷新会绕过本地缓存，重新请求带参数的页面。
• Varnish缓存遗漏：Varnish默认可能忽略URL参数缓存页面，导致带不同参数的销售页被缓存成同一个版本，设置session的逻辑根本没机会执行。

3. 代码可靠性问题 #

你用了global $woocommerce来调用session，不如WC()->session可靠；而且没有对GET参数做安全校验，也没检查Session是否已经初始化。

二、修正后的代码 #

我把你的代码做了针对性修复，解决上述所有问题：

function save_email() {
    // 仅在销售页处理GET参数
    if ( is_page( 'sales-page' ) && ! empty( $_GET ) ) {
        // 确保WooCommerce Session已初始化
        if ( ! WC()->session->has_session() ) {
            WC()->session->set_customer_session_cookie( true );
        }

        // 安全处理邮箱参数并存入Session
        if ( isset( $_GET['tu_em'] ) && is_email( $_GET['tu_em'] ) ) {
            WC()->session->set( 'tu_em', sanitize_email( $_GET['tu_em'] ) );
        }
        // 安全处理姓名参数并存入Session
        if ( isset( $_GET['tu_name'] ) ) {
            WC()->session->set( 'tu_name', sanitize_text_field( $_GET['tu_name'] ) );
        }
    }
}
// 改用template_redirect钩子，在页面渲染前执行，确保Session可用
add_action( 'template_redirect', 'save_email', 10 );

function override_checkout_email_field( $fields ) {
    // 先检查Session是否存在，避免报错
    if ( WC()->session ) {
        $email = WC()->session->get( 'tu_em' );
        if ( ! is_null( $email ) && is_email( $email ) ) {
            $fields['billing']['billing_email']['default'] = $email;
        }

        $name = WC()->session->get( 'tu_name' );
        if ( ! is_null( $name ) ) {
            $fields['billing']['billing_first_name']['default'] = $name;
        }
    }
    return $fields;
}
add_filter( 'woocommerce_checkout_fields', 'override_checkout_email_field' );

三、额外排查与优化步骤 #

1. 强制销售页不缓存
   在销售页添加禁止缓存的响应头，防止浏览器缓存带参数的页面：

   function disable_sales_page_cache() {
       if ( is_page( 'sales-page' ) ) {
           header( 'Cache-Control: no-cache, no-store, must-revalidate' );
           header( 'Pragma: no-cache' );
           header( 'Expires: 0' );
       }
   }
   add_action( 'template_redirect', 'disable_sales_page_cache', 5 );
   

2. 调整Varnish缓存规则
   确保Varnish在缓存销售页时，将tu_em/tu_name参数和用户Cookie纳入缓存键，避免不同参数的页面被缓存成同一个版本：

   sub vcl_hash {
       if (req.url ~ "^/sales-page") {
           hash_data(req.url); // 把完整URL（含参数）加入缓存键
           hash_data(req.http.Cookie); // 把用户Cookie加入缓存键
       }
   }
   

3. 验证参数传递
   打开浏览器开发者工具的「网络」面板，访问销售页链接，确认tu_em和tu_name参数已经正确出现在请求URL中，并且服务器返回的响应头没有缓存标识。

为什么硬刷新生效？ #

硬刷新会强制浏览器：

• 绕过本地缓存，重新向服务器请求完整的带参数页面；
• 清除部分临时缓存的Cookie，让WooCommerce Session重新初始化；
• 此时你的代码（哪怕有笔误）可能因为缓存失效被正确执行，所以偶然生效。

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