WooCommerce设置结账地址字段非必填提交表单报错问题

我之前也碰到过一模一样的情况——只修改woocommerce_billing_fields里的必填属性根本不够，WooCommerce在结账流程里还有好几层额外的验证逻辑，这就是你看到"Please enter an address to continue"错误的核心原因。下面给你一套完整的解决方案：

1. 先修改账单&配送字段的必填属性 #

首先得把所有地址相关字段的required都设为false（如果你需要电话必填，单独保留即可），同时别忘了处理配送字段（如果你的店铺启用了配送功能）：

// 自定义账单地址字段必填性
add_filter( 'woocommerce_billing_fields', 'customize_billing_fields_required', 20, 1 );
function customize_billing_fields_required( $fields ) {
    // 保持电话必填
    $fields['billing_phone']['required'] = true;
    
    // 将其他账单地址字段设为非必填
    $fields['billing_country']['required'] = false;
    $fields['billing_first_name']['required'] = false;
    $fields['billing_last_name']['required'] = false;
    $fields['billing_address_1']['required'] = false;
    $fields['billing_address_2']['required'] = false;
    $fields['billing_city']['required'] = false;
    $fields['billing_state']['required'] = false;
    $fields['billing_postcode']['required'] = false;
    
    return $fields;
}

// 如果启用配送，自定义配送地址字段必填性
add_filter( 'woocommerce_shipping_fields', 'customize_shipping_fields_required', 20, 1 );
function customize_shipping_fields_required( $fields ) {
    // 所有配送字段设为非必填
    foreach ( $fields as $key => $field ) {
        $fields[$key]['required'] = false;
    }
    return $fields;
}

2. 移除服务器端的强制地址验证 #

WooCommerce有内置的结账验证钩子，即使你把字段设为非必填，它还是会检查是否有地址信息。我们需要把这些默认验证移除：

// 移除结账时的地址必填服务器端验证
add_action( 'woocommerce_checkout_process', 'remove_address_required_validation', 1 );
function remove_address_required_validation() {
    // 移除账单地址强制验证
    remove_action( 'woocommerce_checkout_process', 'woocommerce_checkout_require_billing_address' );
    // 移除配送地址强制验证（启用配送时需要）
    remove_action( 'woocommerce_checkout_process', 'woocommerce_checkout_require_shipping_address' );
}

// 修改默认地址字段的全局必填设置
add_filter( 'woocommerce_default_address_fields', 'customize_default_address_fields_required', 20, 1 );
function customize_default_address_fields_required( $fields ) {
    foreach ( $fields as $key => $field ) {
        $fields[$key]['required'] = false;
    }
    // 单独保留电话必填（如果需要）
    if ( isset( $fields['phone'] ) ) {
        $fields['phone']['required'] = true;
    }
    return $fields;
}

3. 禁用前端的JS验证 #

除了服务器端，WooCommerce前端还有jQuery验证，会阻止用户提交表单。我们需要修改这部分逻辑：

// 禁用结账页面地址字段的前端验证
add_action( 'wp_footer', 'disable_checkout_address_frontend_validation' );
function disable_checkout_address_frontend_validation() {
    if ( is_checkout() && ! is_wc_endpoint_url() ) {
    ?>
    <script>
        jQuery(document).ready(function($) {
            // 移除地址字段的必填样式类
            $('body').on('checkout_place_order', function() {
                $('.billing_address_fields .validate-required').removeClass('validate-required');
                $('.shipping_address_fields .validate-required').removeClass('validate-required');
            });
            
            // 重写jQuery验证规则，仅对电话字段保持必填
            if ( typeof woocommerce_checkout_params !== 'undefined' ) {
                $.validator.addMethod( 'required', function( value, element ) {
                    if ( $(element).hasClass('billing_phone') ) {
                        return $.validator.methods.required.call( this, value, element );
                    }
                    return true;
                }, woocommerce_checkout_params.i18n_required_text );
            }
        });
    </script>
    <?php
    }
}

额外提示 #

• 如果你的店铺不需要配送功能，可以直接在WooCommerce设置→配送里禁用所有配送选项，这样配送地址字段会自动隐藏，省掉很多麻烦。
• 测试代码时建议先在本地/测试环境进行，避免影响线上订单。
• 如果还是有问题，可以检查是否有其他插件（比如多语言、自定义结账插件）或者主题的代码干扰了验证逻辑。

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