WooCommerce中add_action嵌套add_filter可行性及脚本输出问题

一、钩子嵌套相关说明 #

技术上完全支持在add_action回调内注册add_filter，也支持反向嵌套，你之前的代码失效和钩子能不能嵌套没有关系，核心问题是对钩子执行顺序、HTTP请求生命周期的理解错误。

原有代码错误点梳理 #

• 第一种写法错误：wp_footer是页面渲染到最后阶段才触发的钩子，此时加购逻辑绑定的woocommerce_add_cart_item_data早就执行完毕，你在页脚阶段才注册加购过滤器，完全赶不上本次加购的触发时机，代码根本不会运行。
• 第二种写法错误：woocommerce_add_cart_item_data运行在加购逻辑处理阶段，此时还未开始渲染结账页的页脚，直接在此处输出脚本不仅位置错误，且加购完成后WooCommerce会执行302跳转，直接输出的内容会被跳转响应覆盖，根本不会在用户浏览器执行。wc_add_notice能正常触发是因为WooCommerce将通知存储在Session中，等跳转到目标页面后才统一渲染，和直接输出脚本的逻辑完全不同。
• 第三种写法错误：存在两个硬伤，一是将函数定义写在if判断块内，只要该判断块执行过一次，后续再次触发就会抛出「函数重复定义」的致命错误；二是HTTP请求是无状态的，你在加购请求内注册的wp_footer钩子仅在当前加购请求生命周期内有效，加购后的跳转是全新的HTTP请求，之前注册的钩子不会被带到新请求中，自然无法输出脚本。

二、正确实现代码 #

实现核心是通过WooCommerce Session跨请求传递状态标记，加购时写入标记，结账页首次加载检测到标记则输出脚本，输出后立即删除标记，保证仅执行一次：

/**
 * 加购packages分类商品时，写入需要清空localStorage的session标记
 */
add_filter( 'woocommerce_add_cart_item_data', 'set_clear_storage_flag', 10, 3 );
function set_clear_storage_flag( $cart_item_data, $product_id, $variation_id ) {
    if ( ! WC()->session ) {
        return $cart_item_data;
    }
    // 校验商品是否属于packages分类
    if ( has_term( 'packages', 'product_cat', $product_id ) ) {
        WC()->session->set( 'need_clear_localstorage', 1 );
    }
    return $cart_item_data;
}

/**
 * 结账页页脚检测标记，输出脚本后立即删除标记，保证仅执行一次
 */
add_action( 'wp_footer', 'render_clear_storage_script' );
function render_clear_storage_script() {
    if ( ! function_exists( 'is_checkout' ) || ! is_checkout() || ! WC()->session ) {
        return;
    }
    if ( WC()->session->get( 'need_clear_localstorage' ) ) {
        // 输出后立刻清除标记，刷新页面不再触发
        WC()->session->__unset( 'need_clear_localstorage' );
        ?>
        <script type="text/javascript">
            localStorage.clear();
        </script>
        <?php
    }
}

效果说明 #

• 仅当加购packages分类商品后，首次跳转至结账页时，会在页脚位置输出清空localStorage的脚本
• 用户刷新结账页、后续非触发条件下访问结账页，都不会重复输出脚本
• 加购非packages分类商品时不会触发脚本，完全匹配需求规则

内容的提问来源于stack exchange，提问作者wp-ap