WooCommerce购物车页展示产品品牌报invalid_taxonomy错误怎么解决？

你收到的invalid_taxonomy错误是问题的核心：代码中填写的品牌分类法别名，和你站点实际注册的品牌分类法别名不匹配，系统找不到对应的分类法才会返回报错。

具体排查步骤 #

• 第一步：确认站点真实的品牌分类法别名
  进入WordPress后台的品牌列表管理页面，查看浏览器地址栏中taxonomy参数对应的取值，例如地址为wp-admin/edit-tags.php?taxonomy=custom_brand&post_type=product，则实际的分类法别名就是custom_brand。
  常见的品牌分类法别名对应关系：
  • Perfect WooCommerce Brands插件：默认是pwb-brand
  • WooCommerce官方品牌插件：默认是product_brand
  • 部分主题自带品牌功能：别名可能是brand、tb_brand等，以实际查询结果为准
• 第二步：优化代码逻辑，增加错误判断
  原代码未对查询结果做错误校验，即便分类法正确，也可能在无品牌配置、产品未分配品牌的场景下出现异常，建议使用优化后的代码：

  $product_id = apply_filters( 'woocommerce_cart_item_product_id', $cart_item['product_id'], $cart_item, $cart_item_key );
  // 替换下方的xxx为你第一步查询到的真实分类法别名
  $brands = wp_get_post_terms( $product_id, 'xxx', array( 'fields' => 'names' ) );
  if ( ! is_wp_error( $brands ) && ! empty( $brands ) ) {
      echo '<p class="cart-item-brand">' . esc_html( reset( $brands ) ) . '</p>';
  }
  

额外注意事项 #

• 直接修改WooCommerce默认的cart.php模板文件，后续插件升级时会被覆盖，测试功能正常后，建议将修改后的cart.php文件复制到当前主题根目录下的woocommerce/cart/路径下，即可避免升级被覆盖。
• 长期使用更推荐通过woocommerce_after_cart_item_name钩子挂载功能到主题functions.php中，无需修改模板文件，维护成本更低。

内容的提问来源于stack exchange，提问作者Jack The Baker