WooCommerce单品页从产品属性获取ACF字段值返回NULL问题排查

核心问题 #

1. 术语数组未处理：get_the_terms()返回的是术语对象数组（即便产品只有一个属性值），直接使用$terms->taxonomy会触发PHP错误，导致后续代码无法正常执行。
2. ACF字段参数格式错误：针对分类术语的ACF字段，正确的调用格式应为 '分类法名_' . 术语ID，或直接传递术语对象，而非分类法+slug的组合。

修正后的代码 #

// 获取当前产品对象
global $product;
if ( ! $product ) return;

// 获取产品的pa_merk属性术语
$terms = get_the_terms( $product->get_id(), 'pa_merk' );

// 检查术语是否存在且无错误
if ( $terms && ! is_wp_error( $terms ) ) {
    // 取第一个术语（若产品有多个品牌属性值，可按需遍历）
    $term = reset( $terms );
    
    // 方式1：通过「分类法名_术语ID」格式获取字段
    $image = get_field( 'afbeelding_merk', 'pa_merk_' . $term->term_id );
    
    // 方式2：直接传递术语对象，ACF会自动识别（二选一即可）
    // $image = get_field( 'afbeelding_merk', $term );

    // 显示图片（需匹配ACF字段的返回格式）
    if ( $image ) {
        // 若字段返回图像对象
        if ( is_array( $image ) ) {
            echo '<img src="' . esc_url( $image['url'] ) . '" alt="' . esc_attr( $term->name ) . '" />';
        } else {
            // 若字段返回URL字符串
            echo '<img src="' . esc_url( $image ) . '" alt="' . esc_attr( $term->name ) . '" />';
        }
    } else {
        echo '<p>Foto niet gevonden.</p>';
    }
} else {
    echo '<p>Geen merk gevonden.</p>';
}

额外检查项 #

• 确认ACF字段的位置规则已设置为：在「分类法」-「pa_merk」的编辑页面显示该字段。
• 检查ACF图片字段的返回格式：若设置为「图像对象」，需通过$image['url']获取地址；若为「URL」则直接使用变量。
• 确保目标pa_merk术语已正确填写并保存afbeelding_merk字段的值。

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