WooCommerce结账提交时格式化账单电话号码问题排查

让我们一步步拆解这段代码的问题，以及如何修复它来实现你想要的手机号格式化并存储的需求：

1. 最关键的问题：没有将格式化后的手机号写入数据库 #

你的函数最后只是return $phone，但woocommerce_checkout_update_order_meta这个钩子的回调不需要返回值——你得主动把处理后的号码更新到订单的元数据里，否则格式化操作完全不会影响数据库存储的内容，等于白做了。

2. 函数参数与WooCommerce最佳实践不符 #

你注册钩子时指定了10, 2（优先级10，接收2个参数），但函数只定义了$order_id一个参数。虽然这不影响运行，但直接接收第二个参数$order，能省去wc_get_order($order_id)的调用，代码更高效简洁。

3. 手机号获取方式不够规范 #

你通过$order_data['billing']['phone']获取手机号，WooCommerce官方提供了专门的方法$order->get_billing_phone()，用这个方法代码更清晰，也更符合框架的规范。

4. 空值处理逻辑无效 #

当手机号为空时你写了return NULL，但钩子回调不需要返回值，直接终止执行即可，这个返回操作没有实际作用。

5. 缺少订单对象的有效性判断 #

如果wc_get_order($order_id)返回false（比如订单ID无效），后续操作会抛出错误，得先判断订单是否存在再继续处理。

修复后的完整代码 #

add_action( 'woocommerce_checkout_update_order_meta', 'formatPhoneOnComplete', 10, 2 );
function formatPhoneOnComplete( $order_id, $order ) {
    // 先判断订单对象是否有效，避免后续报错
    if ( ! $order ) {
        return;
    }

    $phone = $order->get_billing_phone();
    $phone = trim( $phone );
    // 移除手机号中的空格、横杠、下划线
    $phone = str_replace( [ ' ', '-', '_' ], '', $phone );

    if ( empty( $phone ) ) {
        return;
    }

    // 移除开头的+号和前置0
    $phone = ltrim( ltrim( $phone, '0' ), '+' );
    
    // 处理前缀：只有当号码长度<=11且未带92前缀时，才添加92
    if ( strlen( $phone ) <= 11 && ! str_starts_with( $phone, '92' ) ) {
        $phone = '92' . ltrim( $phone, '0' );
    }

    // 核心操作：将格式化后的手机号更新到订单并保存到数据库
    $order->set_billing_phone( $phone );
    $order->save();
}

额外优化说明 #

• 我添加了! str_starts_with( $phone, '92' )的判断，避免已经带有92前缀的号码被重复添加（比如用户输入923001234567时不会变成92923001234567）。
• 使用set_billing_phone()和save()方法是WooCommerce更新订单数据的官方推荐方式，比直接操作update_post_meta更安全，还能触发框架内置的钩子和验证逻辑。

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