WordPress自定义归档页循环中显示自定义分类section异常求助

问题根源分析 #

你的代码核心问题在于未正确处理get_the_terms()的返回值，加上归档页面循环中$post->ID可能存在的对象同步问题，导致了报错、不显示、重复显示等异常：

• 当文章无分类时，get_the_terms()返回false，强行转数组会得到[false]，循环时访问$category->name就会触发"Attempt to read property on bool"警告；
• 若遇到分类法调用错误，get_the_terms()会返回WP_Error对象，同样会导致遍历异常；
• 归档页面循环中直接用$post->ID可能因全局对象未同步，获取到错误的文章ID，进而出现重复或不显示。

修正后的代码 #

替换原有代码为以下实现，覆盖所有异常场景：

// 获取当前循环文章的section分类
$categories = get_the_terms( get_the_ID(), 'section' );

// 校验返回值：排除无分类、错误情况
if ( $categories && ! is_wp_error( $categories ) ) {
    foreach ( $categories as $category ) {
        // 转义输出，避免XSS和布局问题
        echo '<span class="kat-label">' . esc_html( $category->name ) . '</span>';
    }
}

关键优化点 #

1. 用get_the_ID()替代$post->ID：归档页面循环中，get_the_ID()能直接获取当前循环内文章的ID，比直接调用全局$post对象更可靠，避免对象同步问题；
2. 增加返回值校验：先判断$categories有效且不是错误对象，再执行循环，彻底避免无分类或错误场景下的警告；
3. 输出转义：用esc_html()转义分类名称，符合WordPress开发安全规范，防止特殊字符破坏页面结构。

重复显示的额外排查 #

如果仍存在分类重复显示的情况，检查以下两点：

• 确认归档页面使用标准WordPress循环结构：

  if ( have_posts() ) {
      while ( have_posts() ) {
          the_post();
          // 分类显示代码放在这里
      }
  }
  

• 若使用了自定义查询，在查询结束后务必调用wp_reset_postdata()，重置全局$post对象，避免后续循环混乱。

为什么单页面正常？ #

单篇文章页面只有一个文章实例，全局$post对象明确，且无多文章循环的对象同步问题，即使代码不严谨也不容易触发异常，但归档页面的多循环场景会放大这些问题。

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