WordPress中无法获取WooCommerce产品ID的问题及解决方法

核心原因 #

你直接在functions.php里执行获取ID的代码，时机太早——WordPress还没完成页面查询构建，全局变量$product也未初始化，所以返回0或false。

解决办法 #

1. 绑定到正确的WordPress/WooCommerce钩子 #

将获取ID的代码放到页面查询完成后的钩子中，比如template_redirect或产品页面专属钩子woocommerce_single_product_summary，确保代码在产品页面环境下运行。

示例代码：

// 绑定到template_redirect钩子，在页面模板加载前执行
add_action('template_redirect', 'fetch_current_product_id');
function fetch_current_product_id() {
    // 仅在单个产品页面执行逻辑
    if (is_product()) {
        // 方法1：使用get_queried_object_id
        $post_id = get_queried_object_id();
        var_dump($post_id);

        // 方法2：使用get_the_ID
        $apost_id = get_the_ID();
        var_dump($apost_id);

        // 方法3：调用全局$product，兼容未初始化情况
        global $product;
        if (!isset($product) || !$product) {
            // 手动从当前查询对象获取产品
            $product = wc_get_product(get_queried_object_id());
        }
        if ($product) {
            $prodid = $product->get_id();
            var_dump($prodid);
        }
    }
}

2. 其他排查方向 #

• 检查自定义模板：如果主题修改了single-product.php，确认模板里是否保留了WooCommerce的核心查询逻辑，有没有覆盖产品查询导致ID丢失。
• 排查插件冲突：临时禁用除WooCommerce、ACF外的所有插件，测试是否能正常获取ID，逐步排查冲突插件。
• 清除缓存：清理WordPress缓存、浏览器缓存，避免旧页面缓存导致的异常。

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