如何调整WooCommerce自定义用户注册字段的错误提示显示顺序

问题原因 #

调整校验逻辑的if判断顺序不生效，是因为WooCommerce核心自带的注册字段（邮箱、密码等）校验逻辑，会优先于你自定义的woocommerce_register_post钩子逻辑执行，核心生成的错误会先加入错误对象，导致最终错误顺序和你期望的字段顺序不匹配。

解决方法 #

方法1：重写全量校验逻辑（最稳定）

直接移除WooCommerce默认的注册校验函数，按照你期望的错误顺序重写全部校验规则：

1. 先移除默认校验钩子

remove_action( 'woocommerce_register_post', 'wc_process_registration_errors', 10 );

2. 自定义全量校验函数，按期望顺序写校验逻辑后挂载到同个钩子

add_action( 'woocommerce_register_post', 'custom_sort_registration_validation', 10, 3 );
function custom_sort_registration_validation( $username, $email, $validation_errors ) {
    // 1. 校验名
    if ( empty( $_POST['billing_first_name'] ) ) {
        $validation_errors->add( 'first_name_error', '请输入您的名' );
    }
    // 2. 校验姓
    if ( empty( $_POST['billing_last_name'] ) ) {
        $validation_errors->add( 'last_name_error', '请输入您的姓' );
    }
    // 3. 校验出生日期
    if ( empty( $_POST['birth_date'] ) ) {
        $validation_errors->add( 'birth_date_error', '请选择出生日期' );
    }
    // 4. 校验邮箱
    if ( empty( $email ) || ! is_email( $email ) ) {
        $validation_errors->add( 'email_error', '请输入有效的邮箱地址' );
    }
    // 5. 校验确认邮箱
    if ( empty( $_POST['confirm_email'] ) || $_POST['confirm_email'] !== $email ) {
        $validation_errors->add( 'confirm_email_error', '两次输入的邮箱不一致' );
    }
    // 6. 校验密码
    if ( empty( $_POST['password'] ) ) {
        $validation_errors->add( 'password_error', '请输入密码' );
    }
    // 7. 校验确认密码
    if ( empty( $_POST['confirm_password'] ) || $_POST['confirm_password'] !== $_POST['password'] ) {
        $validation_errors->add( 'confirm_password_error', '两次输入的密码不一致' );
    }
    // 8. 校验手机号
    if ( empty( $_POST['phone'] ) || ! preg_match('/^1[3-9]\d{9}$/', $_POST['phone']) ) {
        $validation_errors->add( 'phone_error', '请输入有效的手机号' );
    }
    return $validation_errors;
}

代码中的字段名、错误提示、错误码可根据你实际的自定义字段调整。

方法2：拦截错误输出重新排序（无需修改原有校验逻辑）

如果不想改动已经写好的校验逻辑，可以在错误输出前通过钩子重新排序错误数组：

add_filter( 'woocommerce_form_errors', 'custom_reorder_registration_errors', 10, 2 );
function custom_reorder_registration_errors( $errors, $form_id ) {
    // 仅处理注册表单错误
    if ( $form_id !== 'register' ) return $errors;
    
    // 按期望的错误顺序填写对应的错误码，和你校验时add的错误码保持一致
    $expected_order = [
        'first_name_error',
        'last_name_error',
        'birth_date_error',
        'email_error',
        'confirm_email_error',
        'password_error',
        'confirm_password_error',
        'phone_error'
    ];

    $sorted_errors = [];
    // 按自定义顺序提取错误
    foreach ( $expected_order as $code ) {
        if ( isset( $errors->errors[$code] ) ) {
            $sorted_errors[$code] = $errors->errors[$code];
            unset( $errors->errors[$code] );
        }
    }
    // 剩余未匹配的错误追加到末尾
    if ( ! empty( $errors->errors ) ) {
        $sorted_errors = array_merge( $sorted_errors, $errors->errors );
    }

    $errors->errors = $sorted_errors;
    return $errors;
}

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