WooCommerce：woocommerce_product_get_price过滤器多次触发问题及替代方案咨询

首先得明确：你遇到的这个多次触发情况不是操作错误，是WooCommerce本身的设计导致的。这个钩子会在系统需要获取产品价格的任何地方被调用——比如单个产品页里，常规价展示、销售价检查、加入购物车按钮的价格读取、甚至是产品元数据里的价格引用，都会触发它；归档页则可能还要加上价格区间计算、每个产品的多个价格维度检查，所以次数会更多。

那怎么解决复杂代码重复执行的问题？给你两个方向的方案：

1. 优化现有钩子代码，避免重复计算 #

既然钩子必须触发多次，那我们可以把复杂计算的结果缓存起来，只执行一次计算，后续触发直接返回缓存值。用静态变量就能轻松实现：

add_filter('woocommerce_product_get_price', 'custom_product_price', 10, 2);
function custom_product_price($price, $product) {
    // 用静态数组存储已计算的产品价格，键为产品ID
    static $cached_prices = [];
    
    $product_id = $product->get_id();
    // 只有当该产品价格未缓存时，才执行复杂计算
    if (!isset($cached_prices[$product_id])) {
        // 这里替换成你的复杂价格计算逻辑
        $calculated_price = your_complex_price_logic($product);
        $cached_prices[$product_id] = $calculated_price;
    }
    
    return $cached_prices[$product_id];
}

这样不管钩子触发多少次，每个产品的复杂逻辑只会跑一次，性能问题就解决了。

2. 选择更合适的钩子，从根源减少触发次数 #

根据你的需求场景，选对应钩子能大幅降低触发频率：

如果你只需要修改前端显示的价格 #

用woocommerce_get_price_html钩子，它只在渲染价格HTML的时候触发，单个产品页和归档页都只会触发一次（每个产品），完美适配前端展示需求：

add_filter('woocommerce_get_price_html', 'custom_price_display_html', 10, 2);
function custom_price_display_html($price_html, $product) {
    // 执行你的复杂价格计算
    $custom_price = your_complex_price_logic($product);
    // 生成新的价格HTML，替换原有内容
    $price_html = wc_price($custom_price);
    
    // 如果需要保留销售价/常规价的样式，也可以在这里自定义HTML结构
    return $price_html;
}

如果你需要修改实际交易的价格（比如加入购物车、结算时的价格） #

这种场景下，直接修改产品原始价格可能会影响其他功能，更推荐用购物车相关的钩子来单独设置交易价格：

// 第一步：产品加入购物车时，存储自定义价格到购物车项数据中
add_filter('woocommerce_add_cart_item_data', 'store_custom_cart_price', 10, 3);
function store_custom_cart_item_data($cart_item_data, $product_id, $variation_id) {
    $target_product = wc_get_product($product_id);
    $custom_price = your_complex_price_logic($target_product);
    
    // 将自定义价格存入购物车项
    $cart_item_data['custom_transaction_price'] = $custom_price;
    // 添加唯一键，避免相同产品被合并（如果不需要可以去掉）
    $cart_item_data['unique_custom_price_key'] = md5(microtime() . rand());
    
    return $cart_item_data;
}

// 第二步：计算购物车总价时，应用自定义价格
add_action('woocommerce_before_calculate_totals', 'apply_custom_cart_price', 10, 1);
function apply_custom_cart_price($cart) {
    // 后台非AJAX请求时跳过，避免影响后台操作
    if (is_admin() && !defined('DOING_AJAX')) return;
    
    foreach ($cart->get_cart() as $cart_item) {
        if (isset($cart_item['custom_transaction_price'])) {
            // 设置购物车项的实际价格
            $cart_item['data']->set_price($cart_item['custom_transaction_price']);
        }
    }
}

这种方式只会在用户加入购物车和结算计算时触发，完全不会影响前端价格展示以外的其他功能，逻辑更清晰。

内容的提问来源于stack exchange，提问作者José María Lamela Real