调用get_terms()返回Invalid Taxonomy报错的技术求助

你提到的问题我很熟悉——无参数调用get_terms()能拿到全站术语，但指定分类法就失效还报错，而且代码得在循环外运行、没法传ID。我给你几个针对性的排查和解决方向：

• 先确认分类法参数的正确性
  这是最常见的坑！get_terms()里的taxonomy参数必须填分类法的slug，不是显示名称。比如默认文章分类是category，标签是post_tag，自定义分类法要填你注册时写的slug值。举个正确的调用示例：

  // 获取自定义分类法"product_cat"下的所有术语
  $terms = get_terms( array(
      'taxonomy' => 'product_cat',
      'hide_empty' => false, // 可选：如果需要包含没有关联内容的术语
  ) );
  

  如果slug写错，就会触发“分类法不存在”的错误。

• 确保代码在WordPress环境完全初始化后运行
  循环外的代码（比如直接写在主题模板顶部、functions.php里的裸代码）可能在分类法还没注册完成时就执行了，导致get_terms()找不到目标分类法。解决办法是把代码挂到合适的钩子上，比如wp_loaded或者init：

  add_action( 'wp_loaded', 'fetch_my_target_terms' );
  function fetch_my_target_terms() {
      $terms = get_terms( array(
          'taxonomy' => '你的分类法slug',
          'hide_empty' => false,
      ) );
      
      // 处理结果：先判断是否出错
      if ( is_wp_error( $terms ) ) {
          echo '调用错误：' . $terms->get_error_message();
          return;
      }
      
      if ( ! empty( $terms ) ) {
          foreach ( $terms as $term ) {
              // 这里可以输出或处理术语，比如echo $term->name;
          }
      } else {
          echo '该分类法下没有术语';
      }
  }
  

• 排查分类法的权限与可见性设置
  如果你的分类法是自定义注册的，检查注册时的参数：如果设置了public => false，或者show_ui => false，可能会导致前端/循环外调用无法获取术语。可以在注册分类法时调整这些参数，或者在get_terms()里明确指定获取公开术语的规则。

• 先捕获错误信息定位问题
  你提到调用时报错，但没说具体错误内容。可以先通过is_wp_error()捕获错误，打印出具体信息，这样能快速定位是分类法不存在、权限问题还是其他原因：

  $terms = get_terms( array( 'taxonomy' => '你的分类法slug' ) );
  if ( is_wp_error( $terms ) ) {
      var_dump( $terms->get_error_message() ); // 输出具体错误
  }
  

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