使用WordPress的list_terms_exclusions筛选器排除分类后默认视图无结果显示的问题排查

你的代码出现这个问题的核心是SQL语法错误：

当你进入分类页面的默认视图时，list_terms_exclusions筛选器传入的$exclusions参数是空字符串。你的代码直接拼接了' AND t.term_id NOT IN (...)'，导致最终生成的SQL WHERE子句变成了：

WHERE AND t.term_id NOT IN (1,2,3...)

这种语法错误会让数据库无法正确执行查询，自然返回空结果。

而当你点击排序后，WordPress的查询逻辑会给$exclusions添加一些基础条件，此时你的AND就有了合法的前置条件，SQL语法恢复正常，所以能正确返回符合要求的分类列表。

我们需要修改代码，处理$exclusions为空的情况，同时增加一些边界判断避免其他潜在问题：

add_filter( 'list_terms_exclusions', 'nsf_exclude_cats', 20 );
function nsf_exclude_cats( $exclusions ) {
    global $pagenow;
    global $nsf_exclude;

    // 仅在分类管理页面生效，且用户角色正确、排除数组非空
    if ( current_user_can( 'krets_editor' ) && is_admin() && $pagenow === 'edit-tags.php' && !empty( $nsf_exclude ) ) {
        // 拼接排除条件
        $exclude_condition = ' t.term_id NOT IN (' . implode( ',', $nsf_exclude ) . ')';
        
        // 根据原始exclusions是否为空，决定是否添加AND
        if ( !empty( $exclusions ) ) {
            $exclusions .= ' AND' . $exclude_condition;
        } else {
            $exclusions = $exclude_condition;
        }
    }
    return $exclusions;
}

• 增加了$pagenow === 'edit-tags.php'判断：确保这个过滤逻辑只在分类管理页面生效，避免影响其他后台页面的术语查询（比如标签、自定义分类法）。
• 增加了!empty( $nsf_exclude )判断：防止当排除数组为空时，生成NOT IN ()这种无效的SQL语句。
• 使用implode()替代循环拼接：更简洁高效地生成IN子句的内容，避免手动处理最后一个逗号的麻烦。

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