WooCommerce中wc_get_orders写在function.php返回空数组问题

架构老林

2026-8-27

直接在functions.php调用wc_get_orders返回空数组的原因

核心问题是WordPress/ WooCommerce的加载执行时机不对：

functions.php是主题启动阶段最早加载的文件之一，你在文件根作用域直接写查询代码执行时，WooCommerce的核心初始化流程还没跑完：包括订单对应的shop_order自定义文章类型未注册、所有订单状态未注册、WC_Order_Query查询类的前置过滤逻辑未挂载，这时候执行查询自然匹配不到任何订单数据，返回空数组。
你写在woocommerce_order_status_changed钩子中的代码能正常运行，是因为这个钩子本身是WooCommerce处理订单状态流转时才会触发的，触发节点WooCommerce已经完成了全部核心初始化，所有依赖的类、自定义类型、查询逻辑都已加载就绪，自然可以正常返回查询结果。

正确的调用方式

不要在functions.php的顶层作用域直接写业务执行逻辑，把查询代码挂载到WooCommerce初始化完成的专属钩子woocommerce_init上再执行即可，参考代码：

add_action('woocommerce_init', 'custom_get_latest_orders');
function custom_get_latest_orders() {
    // 增加权限判断，避免普通访客访问时也执行查询，拖慢性能、泄露数据
    if (!current_user_can('manage_woocommerce')) {
        return;
    }

    $args = array(
        'limit' => 3,
        // 建议明确指定需要查询的订单状态，避免不同版本默认过滤规则不一致导致漏数据
        'status' => array('completed', 'processing', 'pending', 'on-hold'),
    );
    $orders = wc_get_orders($args);
    
    // 调试请将结果写入调试日志，不要直接var_dump到前端，避免破坏页面结构、泄露敏感信息
    error_log(print_r($orders, true));
}