WooCommerce动态更新运费：如何传递API获取的运费至设置函数

核心问题分析 #

你之前的代码失效，本质是API获取的运费变量作用域不匹配——把woocommerce_package_rates过滤器注册在API请求函数内部，过滤器触发时，API请求函数的局部变量已经销毁，无法传递价格。而用全局变量又存在请求生命周期丢失的风险，最可靠的方案是用WooCommerce会话存储运费数据。

解决方案代码 #

1. 获取API运费并存储到会话

function fetch_shipping_price_from_api() {
    // 替换为你的实际API请求逻辑
    $api_request = wp_remote_get('https://your-shipping-api-url.com');
    
    if (is_wp_error($api_request)) {
        return;
    }
    
    $response_data = json_decode(wp_remote_retrieve_body($api_request), true);
    
    // 假设API返回的运费字段为shipping_cost，根据实际结构调整
    if (isset($response_data['shipping_cost'])) {
        // 将运费存入WooCommerce会话，跨函数/请求阶段可访问
        WC()->session->set('api_shipping_price', $response_data['shipping_cost']);
        
        // 清除配送费率缓存，强制WooCommerce读取新价格
        WC()->session->set('shipping_for_package_0', false);
    }
}
// 绑定触发时机：购物车更新、结算页加载时自动拉取最新运费
add_action('woocommerce_cart_updated', 'fetch_shipping_price_from_api');
add_action('woocommerce_checkout_init', 'fetch_shipping_price_from_api');

2. 从会话取数据更新配送价格

function update_shipping_rates_with_api_price($rates, $package) {
    // 从会话中取出存储的API运费
    $api_shipping_price = WC()->session->get('api_shipping_price');
    
    // 如果没有获取到有效价格，直接返回原费率
    if (!$api_shipping_price) {
        return $rates;
    }
    
    // 遍历所有配送方式，按需更新价格
    foreach ($rates as $rate_key => $rate) {
        // 示例：仅更新flat_rate类配送方式，可根据实际ID调整
        if (str_contains($rate_key, 'flat_rate')) {
            $rates[$rate_key]->cost = $api_shipping_price;
            // 若需同步更新税费，可在此处设置（比如清空或按比例计算）
            $rates[$rate_key]->taxes = array();
        }
    }
    
    return $rates;
}
// 绑定过滤器，优先级设为10，确保能覆盖默认费率
add_filter('woocommerce_package_rates', 'update_shipping_rates_with_api_price', 10, 2);

关键注意事项 #

• 缓存清除：必须调用WC()->session->set('shipping_for_package_0', false)，否则WooCommerce会复用缓存的旧配送费率，新价格无法生效。
• 配送方式匹配：通过$rate_key精准匹配需要更新的配送方式（比如flat_rate:2），避免误改所有配送方式价格。
• API错误处理：保留is_wp_error判断，防止API请求失败时破坏正常配送逻辑。

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