Woocommerce 3.3.4中wc_get_product_terms调用变体ID返回空数组求助

遇到这种情况确实挺闹心的，我给你整理了一套逐步排查的思路，你可以跟着一步步来定位问题：

1. 先确认基础信息没搞错 #

• 先核对13174是不是真的那个变体的ID：去WP后台产品列表找到这个变体，看地址栏里的post=参数是不是13174，别把父可变产品的ID当成变体ID了。
• 再检查属性的taxonomy名称对不对：你用的是pa_size，WooCommerce里属性的taxonomy是pa_加上属性的slug，所以去「产品 > 属性」里找到Size属性，看看它的slug是不是size（全小写、没空格的那种），别因为拼写错了导致查不到。

2. 直接查数据库验证数据到底在不在 #

有时候函数返回空可能是逻辑层的问题，直接查数据库最靠谱：

• 用phpMyAdmin或者你的数据库管理工具跑这条SQL（记得把wp_换成你自己的数据库前缀）：

  SELECT * FROM wp_term_relationships WHERE object_id = 13174 AND term_taxonomy_id IN (SELECT term_taxonomy_id FROM wp_term_taxonomy WHERE taxonomy = 'pa_size');
  

• 如果这条查询有结果，说明数据是存在的，问题出在函数调用或者过滤逻辑上；要是没结果，那就是这个变体压根没关联上Size属性的"1"选项，得去后台重新设置变体属性。

3. 去后台检查变体的属性设置 #

• 打开父可变产品的编辑页面，切换到「产品数据」里的「变体」标签，找到这个变体，看看它的Size属性是不是真的选了"1"。有时候保存的时候可能出bug，导致属性没关联上。
• 试着重新保存一遍：先把Size改成别的选项，点保存，再改回"1"再保存，之后再调用wc_get_product_terms(13174, "pa_size")试试。

4. 调整函数调用的参数和上下文 #

• wc_get_product_terms默认参数可能被主题或插件改了，你可以显式指定参数测试：

  $terms = wc_get_product_terms(13174, 'pa_size', array(
      'fields' => 'all',
      'hide_empty' => false
  ));
  var_dump($terms);
  

  加个hide_empty => false能确保就算这个术语没被其他产品用，也会返回结果。
• 检查你是不是在产品还没加载完的时候调用这个函数，比如在一些早期的钩子里面。可以试试在template_redirect钩子里调用测试，确保产品数据已经加载完整：

  add_action('template_redirect', function() {
      $terms = wc_get_product_terms(13174, 'pa_size');
      var_dump($terms);
  });
  

5. 排查主题和插件冲突 #

• 先暂时切换到WP默认主题（比如Twenty Twenty-One），再测试函数返回结果。如果正常了，那就是你当前的主题修改了WooCommerce的术语查询逻辑。
• 逐个禁用第三方插件（只留WooCommerce），每禁一个就测一次，找到哪个插件搞的鬼。有些插件会过滤get_terms或者wc_get_product_terms的结果，导致返回空。

6. 看日志找错误线索 #

• 开启WP调试模式：在wp-config.php里加这段代码，然后重新调用函数，去wp-content/debug.log里看看有没有相关错误：

  define('WP_DEBUG', true);
  define('WP_DEBUG_LOG', true);
  define('WP_DEBUG_DISPLAY', false);
  

• 去WooCommerce的系统状态报告看看：在后台「WooCommerce > 状态 > 系统状态」里，有没有关于属性、变体的错误提示，比如数据库表缺失、版本兼容问题之类的。

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