WooCommerce生成随机订单号并防止重复生成的解决方法

问题原因 #

原代码未对首次生成的随机字符串做持久化存储，每次系统调用woocommerce_order_number钩子获取订单号时都会重新执行随机串生成逻辑，导致同一订单在不同场景下展示的订单号不一致，无法正常用于订单查询、对账等业务场景。

修复逻辑 #

• 随机字符串仅在订单首次生成订单号时生成一次
• 生成后的随机串作为订单私有元数据永久存储到订单记录中
• 后续获取订单号时直接读取已存储的随机串拼接订单ID，保证同一订单号全局唯一固定

修正后完整代码 #

/**
 * 生成指定长度的随机字符串
 * @param int $length 随机串长度
 * @return string
 */
function generate_random_string( $length = 5 ) {
    return substr( str_shuffle( str_repeat( $x = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ', ceil( $length / strlen( $x ) ) ) ), 1, $length );
}

add_filter( 'woocommerce_order_number', 'ct_change_woocommerce_order_number', 1, 2 );
function ct_change_woocommerce_order_number( $order_id, $order ) {
    // 定义存储随机前缀的元数据键名，下划线开头为私有字段，不会在后台编辑页展示
    $meta_key = '_custom_order_random_prefix';
    // 先尝试读取已存储的随机前缀
    $random_prefix = $order->get_meta( $meta_key, true );
    
    // 如果没有存储过，就生成新的随机串并保存
    if ( empty( $random_prefix ) ) {
        $random_prefix = generate_random_string(5);
        $order->update_meta_data( $meta_key, $random_prefix );
        $order->save();
    }
    
    // 拼接随机前缀+原始订单ID作为最终订单号
    return $random_prefix . $order->get_id();
}

使用说明 #

将上述代码添加到当前主题的functions.php文件，或者通过自定义代码片段插件添加即可生效。代码生效后新生成的订单会自动绑定固定随机前缀，历史订单在首次被访问读取订单号时也会自动补全绑定固定随机前缀，不会出现后续订单号变动的问题。代码兼容WooCommerce HPOS高性能订单存储模式。

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