WordPress AJAX加载商品列表时莫名出现"0"的问题求助

核心原因及修复方案 #

1. 输出缓冲未正确使用 #

WordPress的WP_Query相关函数（比如have_posts()）会返回布尔值，当你在AJAX回调里直接输出内容时，循环结束后have_posts()返回的false会被转换成"0"输出。哪怕你移除了商品模板调用，只要查询逻辑里存在未被捕获的布尔值输出，就会出现这个问题。

修复代码示例：

function my_ajax_product_list() {
    // 开启输出缓冲，捕获所有要返回的内容
    ob_start();

    // 获取用户元数据并构建查询参数
    $user_meta = get_user_meta(get_current_user_id(), 'your_meta_key', true);
    $query_args = array(
        'post_type' => 'product',
        'meta_query' => array(
            array('key' => 'target_product_meta', 'value' => $user_meta)
        )
    );
    $product_query = new WP_Query($query_args);

    if ($product_query->have_posts()) {
        while ($product_query->have_posts()) {
            $product_query->the_post();
            // 这里写商品渲染逻辑，哪怕注释掉也不影响排查核心问题
            // wc_get_template_part('content', 'product');
        }
        wp_reset_postdata();
    }

    // 提取缓冲内容并关闭缓冲
    $response_content = ob_get_clean();
    // 只输出我们需要的内容
    echo $response_content;
    // 必须用wp_die()结束AJAX请求，避免额外输出
    wp_die();
}
add_action('wp_ajax_load_user_products', 'my_ajax_product_list');
add_action('wp_ajax_nopriv_load_user_products', 'my_ajax_product_list');

2. AJAX回调未用wp_die()收尾 #

如果你的回调最后用了exit()或die()而非WordPress标准的wp_die()，可能会触发默认的额外输出。wp_die()会正确终止AJAX请求，避免系统自动返回多余内容。

3. 隐式输出排查 #

检查回调函数里的每一行，确保没有不小心写出echo $product_query->have_posts();这类语句，也不要让函数的返回值被自动输出（比如函数没有用return，而是直接执行逻辑时带出了布尔值输出）。

4. 第三方代码干扰 #

暂时切换到WordPress默认主题（如Twenty Twenty-Four），禁用所有非必要插件，测试是否还会出现"0"。如果消失了，再逐个恢复插件/主题，定位是哪个代码片段在AJAX请求中添加了额外输出。

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