get_terms查询分页结果异常求助：排序与分页不符合预期

从你提供的SQL语句能看到，get_terms生成的查询用了ORDER BY 1 ASC（也就是按SELECT的第一个字段t.term_id排序），但你明明指定了orderby => 'name'，这说明WordPress的WP_Term_Query没有正确把排序参数转换成对应的SQL语句，再加上手动计算的offset分页参数，就导致后续页面返回乱序的重复结果。

方案1：改用paged参数替代手动计算offset #

WordPress的WP_Term_Query原生支持paged参数，不需要手动计算offset，能避免手动分页带来的排序与分页逻辑冲突：

$mvp_posts_num = 12;
// 注意：自定义页面模板用get_query_var('page')，档案类页面用get_query_var('paged')，根据你的页面类型调整
$paged = get_query_var('page') ? get_query_var('page') : 1 ;

$args = array(
    'taxonomy'   => array( 'city' ),
    'number'     => $mvp_posts_num,
    'paged'      => $paged, // 改用原生paged参数
    'hide_empty' => false,
    'order'      => 'ASC',
    'orderby'    => 'name',
    'meta_query' => array(
        'relation' => 'AND',
        array(
            'key'     => 'country_code',
            'compare' => 'EXISTS',
        ),                                  
    ),
);
$term_query = get_terms( $args );

方案2：强制修正SQL的ORDER BY子句 #

如果方案1无效，通过terms_clauses过滤器直接修改生成的SQL，确保按术语名称排序：

// 添加过滤器，针对city分类法修正排序逻辑
add_filter('terms_clauses', function($clauses, $taxonomies, $args) {
    if (in_array('city', $taxonomies) && isset($args['orderby']) && $args['orderby'] === 'name') {
        // 强制替换ORDER BY为按术语名称排序
        $clauses['orderby'] = 'ORDER BY t.name ' . $args['order'];
    }
    return $clauses;
}, 10, 3);

// 原查询代码保持不变
$mvp_posts_num = 12;                           
$paged = get_query_var('page') ? get_query_var('page') : 1 ;

$args = array(
    'taxonomy'   => array( 'city' ),
    'number'     => $mvp_posts_num,
    'offset'     => ((int)$paged - 1) * $mvp_posts_num,
    'hide_empty' => false,
    'order'      => 'ASC',
    'orderby'    => 'name',
    'meta_query' => array(
        'relation' => 'AND',
        array(
            'key'     => 'country_code',
            'compare' => 'EXISTS',
        ),                                  
    ),
);
$term_query = get_terms( $args );

方案3：禁用DISTINCT查询 #

你的meta_query只是检查country_code元数据是否存在，每个术语只会对应一条元数据记录，不需要使用DISTINCT。在参数中添加'distinct' => false，避免因DISTINCT导致的排序字段缺失问题：

$args = array(
    'taxonomy'   => array( 'city' ),
    'number'     => $mvp_posts_num,
    'offset'     => ((int)$paged - 1) * $mvp_posts_num,
    'hide_empty' => false,
    'order'      => 'ASC',
    'orderby'    => 'name',
    'distinct'   => false, // 禁用DISTINCT查询
    'meta_query' => array(
        'relation' => 'AND',
        array(
            'key'     => 'country_code',
            'compare' => 'EXISTS',
        ),                                  
    ),
);
$term_query = get_terms( $args );

1. 缓存问题：WordPress会缓存get_terms的查询结果，尝试清除站点缓存后重新测试。
2. 参数正确性：确认get_query_var('page')是否能正确获取分页页码，若为档案类页面，应改用get_query_var('paged')。

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