ACF字段Series值相同的产品标题无法显示问题排查

你遇到的核心问题是短代码完全无输出，连提示都没出现，说明代码执行初期就出了问题，按以下步骤排查修复：

1. 先确认ACF字段能正确获取值 #

你的代码里第一行就尝试输出$series_value，但页面没显示，说明get_field('series')根本没拿到值，大概率是这两个原因：

• 字段键写错：去ACF后台检查这个Series字段的「字段键」是不是series（ACF字段键是小写，别把显示名当成字段键）；
• 上下文post ID不对：WooCommerce单产品页里，模板的全局$post可能不是当前产品，要手动指定ID：

  $series_value = get_field('series', get_the_ID());
  

2. 完善WP_Query查询参数 #

即使拿到字段值，原查询也有几个坑：

• 默认只返回10条产品，需加'posts_per_page' => -1显示所有同系列产品；
• 会把当前产品也列出来，建议加'post__not_in' => array(get_the_ID())排除当前产品；
• 用ACF的meta_query替代直接写meta_key/meta_value，适配更多字段类型（比如下拉、单选框）。

3. 增加空值判断与调试提示 #

如果字段值为空，直接输出提示，避免页面空白。

修正后的完整代码 #

function display_related_titles_by_series() {
    // 获取当前产品ID，强制指定上下文
    $current_product_id = get_the_ID();
    $series_value = get_field('series', $current_product_id);

    // 字段值为空时直接返回提示
    if (empty($series_value)) {
        return '暂无同系列出版物';
    }

    // 查询同系列产品，排除当前产品
    $args = array(
        'post_type'      => 'product',
        'posts_per_page' => -1,
        'post__not_in'   => array($current_product_id),
        'meta_query'     => array(
            array(
                'key'     => 'series',
                'value'   => $series_value,
                'compare' => '='
            )
        )
    );

    $related_posts = new WP_Query($args);

    // 输出结果（用字符串拼接替代多次echo，更规范）
    if ($related_posts->have_posts()) {
        $output = '<h3>同系列出版物</h3><ul>';
        while ($related_posts->have_posts()) {
            $related_posts->the_post();
            // 加上产品链接，提升实用性
            $output .= '<li><a href="' . get_permalink() . '">' . get_the_title() . '</a></li>';
        }
        $output .= '</ul>';
        wp_reset_postdata();
        return $output;
    } else {
        return '暂无同系列出版物';
    }
}
add_shortcode('related_titles', 'display_related_titles_by_series');

额外注意事项 #

• 短代码调用：确保在单产品页正确添加了[related_titles]，如果是在模板文件里调用，要用echo do_shortcode('[related_titles]');；
• 缓存问题：修改代码后没生效的话，清空WordPress缓存和浏览器缓存再测试。

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