WooCommerce设置：非沙特阿拉伯地区需必填结账邮编字段问题排查

原代码没法实现需求的原因很明确：

• woocommerce_checkout_fields钩子只在结账页面首次加载时执行一次，用户切换国家后不会自动重新运行，前端字段的必填状态不会实时更新。
• 依赖$_POST['billing_country']只有表单提交时才有值，页面初始化阶段根本拿不到当前选中的国家，逻辑自然失效。

下面是完整的解决方法，分后端逻辑和前端实时交互两部分：

1. 后端代码（处理初始化与提交验证） #

把这段代码加到主题的functions.php里，或者用代码片段插件添加：

// 初始化结账字段，根据当前国家设置邮编必填状态
function custom_set_postcode_required_status( $fields ) {
    // 获取当前生效的国家：优先用户已设置的 billing 国家，没有则用店铺默认国家
    $current_country = WC()->customer->get_billing_country();
    if ( empty( $current_country ) ) {
        $default_country = get_option( 'woocommerce_default_country' );
        // 拆分默认国家格式（比如 SA:01），只取国家代码部分
        $current_country = explode( ':', $default_country )[0];
    }

    // 非沙特(SA)国家时，邮编设为必填；否则设为非必填
    $fields['billing']['postcode']['required'] = ( $current_country !== 'SA' );
    return $fields;
}
add_filter( 'woocommerce_checkout_fields', 'custom_set_postcode_required_status', 20 );

// 结账提交时的后端验证，防止前端绕过验证
function custom_validate_postcode_on_submit() {
    if ( isset( $_POST['billing_country'] ) && $_POST['billing_country'] !== 'SA' ) {
        if ( empty( $_POST['billing_postcode'] ) ) {
            wc_add_notice( '请填写邮编字段。', 'error' );
        }
    }
}
add_action( 'woocommerce_checkout_process', 'custom_validate_postcode_on_submit' );

2. 前端JS代码（实时切换字段状态） #

这段代码用来监听国家选择框的变化，实时更新邮编字段的必填状态：

jQuery(document).ready(function($) {
    // 切换邮编必填状态的核心函数
    function togglePostcodeRequired() {
        var selectedCountry = $('#billing_country').val();
        var postcodeFieldWrap = $('#billing_postcode_field');
        var postcodeInput = $('#billing_postcode');

        if (selectedCountry !== 'SA') {
            // 添加必填样式和属性
            postcodeFieldWrap.addClass('validate-required');
            postcodeInput.prop('required', true);
        } else {
            // 移除必填样式和属性
            postcodeFieldWrap.removeClass('validate-required');
            postcodeInput.prop('required', false);
            // 清除可能存在的错误提示
            postcodeFieldWrap.find('.woocommerce-error').remove();
        }
    }

    // 页面加载完成后先执行一次，确保初始状态正确
    togglePostcodeRequired();

    // 监听国家选择框的变化事件
    $('#billing_country').on('change', function() {
        togglePostcodeRequired();
        // 触发WooCommerce的结账更新事件，同步验证逻辑
        $(document.body).trigger('update_checkout');
    });
});

补充说明 #

• 如果需要对配送地址的邮编字段做同样设置，把代码里的billing替换成shipping即可。
• JS代码的添加方式：可以放到主题的footer.php文件的</body>标签之前，或者用自定义HTML模块添加到结账页面，也可以用插件（比如Custom CSS & JS）来添加。

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