调整商品数量后Woocommerce购物车表单重复显示问题求助

问题现象 #

• 调整购物车内商品数量（增减）后，整个woocommerce-cart-form表单区域重复显示
• 手动点击「更新购物车」按钮也会触发相同问题
• 调整数量后总价计算正确，刷新页面后显示恢复正常

已做的定制修改 #

仅对数量功能做了一处定制：实现调整数量后自动更新购物车总价（无需点击按钮），代码如下：

add_action( 'wp_footer', function() {

?><script>
jQuery( function( $ ) {
    let timeout;
    $('.woocommerce').on('change', 'input.qty', function(){
        if ( timeout !== undefined ) {
            clearTimeout( timeout );
        }
        timeout = setTimeout(function() {
            $("[name='update_cart']").trigger("click"); // trigger cart update
        }, 1000 ); // 1 second delay, half a second (500) seems comfortable too
    });
} );
</script><?php
} );

已确认该代码并非问题根源，禁用后问题仍存在。

问题截图说明 #

• 调整数量前：
• 调整数量后（Woo提示出现前）：
• 调整数量后（Woo提示出现后）：

解决思路 #

1. 排查购物车模板的重复渲染问题 #

• 检查主题自定义的cart.php模板，确认AJAX更新购物车时是否重复调用了woocommerce-cart-form的渲染代码
• 查看是否存在重复的do_action( 'woocommerce_cart_contents' )或类似钩子调用，导致表单区域被多次输出

2. 排查AJAX更新的响应处理逻辑 #

• WooCommerce默认通过AJAX更新购物车时会返回更新后的购物车HTML片段，检查主题或自定义插件是否重写了woocommerce_update_cart_action_cart_updated钩子，导致响应中包含完整表单而非目标片段
• 确认是否有自定义JS代码在处理AJAX返回时，错误地将新HTML追加到现有表单中，而非替换原有内容

3. 排查插件与主题冲突 #

• 暂时禁用所有非WooCommerce官方插件，逐一恢复排查是否有插件干扰购物车AJAX更新流程
• 切换到WooCommerce默认主题（如Storefront），确认问题是否由主题自定义代码导致

4. 检查核心钩子的异常调用 #

• 查看functions.php中是否存在重复注册的购物车相关动作钩子
• 检查是否有自定义代码错误使用woocommerce_before_cart、woocommerce_after_cart等钩子，导致表单区域被重复渲染

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