WooCommerce调用set_shipping方法修改配送字段不生效问题排查

你使用的set_shipping_*系列函数本身没有问题，出现配送字段未更新的原因是缺少了必要的持久化、会话同步操作，部分场景还和前端表单未同步有关，具体问题和修复方案如下：

核心问题原因 #

• 仅调用set_shipping_*方法只会修改内存中WC_Customer对象的临时属性，没有执行保存操作，修改不会同步到用户会话和数据库，请求结束后修改就会失效
• 未同步刷新购物车的配送相关缓存与会话，结算页读取的配送信息依然是修改前的旧数据
• 如果结算页原生配送表单字段未同步更新，表单提交时会直接读取空的表单值触发校验错误

修复方案 #

1. 修正后端PHP代码 #

添加参数校验、输入过滤、修改保存、购物车会话刷新逻辑，修正后代码如下：

add_action( 'wp_ajax_nopriv_change_shipping_address', 'mytheme_change_shipping_address' );
add_action( 'wp_ajax_change_shipping_address', 'mytheme_change_shipping_address' );

function mytheme_change_shipping_address() {
    // 校验必填参数
    if ( empty($_POST['address']) || empty($_POST['postalCode']) || empty($_POST['city']) ) {
        wp_send_json_error('缺少必要的地址参数');
    }
    // 输入安全过滤
    $address = sanitize_text_field($_POST['address']);
    $postal_code = sanitize_text_field($_POST['postalCode']);
    $city = sanitize_text_field($_POST['city']);

    // 设置配送地址，优先使用明确的address_1方法而非别名，兼容性更好
    WC()->customer->set_shipping_address_1($address);
    WC()->customer->set_shipping_postcode($postal_code);
    WC()->customer->set_shipping_city($city);
    // 持久化保存客户地址修改
    WC()->customer->save();

    // 刷新购物车配送、金额计算与会话
    WC()->cart->calculate_shipping();
    WC()->cart->calculate_totals();
    WC()->cart->set_session();

    wp_send_json_success('地址更新成功');
}

2. 同步更新前端结算表单 #

在AJAX请求成功回调中同步更新结算页原生配送字段的值，同时触发WooCommerce的结算更新事件刷新运费展示，修正后JS代码如下：

const changeShippingAddress = (address, postalCode, city) => {
    wp.ajax.post( "change_shipping_address", {
        address,
        postalCode,
        city
    } )
        .done(function(response) {
            // 以下选择器需和你主题结算页的实际字段ID匹配，如不一致请自行调整
            document.querySelector('#shipping_address_1').value = address;
            document.querySelector('#shipping_postcode').value = postalCode;
            document.querySelector('#shipping_city').value = city;
            // 触发WooCommerce原生结算更新事件，同步刷新运费、金额等信息
            jQuery('body').trigger('update_checkout');
            alert('地址更新成功');
        })
        .fail(err => {
            alert("地址更新失败");
            console.error(err);
        });
}

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