自定义分类Regions关联文章无法通过WP_Query查询显示问题求助

我碰到过好几个开发者遇到过类似的问题，大概率是下面几个常见原因之一，你可以逐一排查：

• 查询参数用错了地方：自定义分类法不能用默认分类的category_name或cat参数来查询，必须用tax_query指定分类法信息。比如要获取所有标记了Regions分类下任意标签的文章，正确的WP_Query写法应该是这样：

$args = array(
    'post_type' => 'post', // 如果你的文章是自定义类型，替换成对应的slug
    'tax_query' => array(
        array(
            'taxonomy' => 'regions', // 必须和你注册的分类法slug完全一致
            'operator' => 'EXISTS', // 表示只要关联了该分类法下的标签就匹配
        ),
    ),
);
$regions_query = new WP_Query( $args );

如果是要查询某个具体标签的文章，就把operator换成IN，加上terms参数指定标签的slug或ID。

• 注册分类法时没关联正确的文章类型：在调用register_taxonomy时，第二个参数必须指定要关联的文章类型（比如默认的post，或者你的自定义文章类型slug）。如果这个参数错了，哪怕文章标记了分类标签，系统也不会把它们关联起来。比如正确的注册代码应该包含：

register_taxonomy(
    'regions',
    'post', // 这里要写你实际用的文章类型，多个的话用数组array('post', 'product')
    array(
        'label' => __('Regions'),
        'rewrite' => array('slug' => 'regions'),
        'hierarchical' => false, // 标签式分类设为false，层级分类设为true
        // 其他配置参数...
    )
);

• 查询时没指定正确的文章类型：WP_Query默认只查询post类型的内容，如果你的那两篇文章是自定义文章类型，就得在查询参数里明确加上'post_type' => '你的自定义类型slug'，不然会漏掉这些文章。

• 拼写错误导致匹配失败：不管是注册分类法时的slug，还是查询时tax_query里的taxonomy参数，只要拼写有偏差（比如把regions写成region），都会导致查询无结果。仔细核对一下两边的拼写是否完全一致。

• 文章状态限制：WP_Query默认只返回publish状态的文章，如果那两篇文章是草稿、私密或者待审核状态，自然查不到。可以临时在参数里加上'post_status' => 'any'来测试，看看是不是状态的问题。

• 缓存干扰：WordPress的各种缓存（包括插件缓存、服务器缓存）可能导致查询结果没有实时更新。先试试清除全站缓存，或者在查询参数里临时加上'cache_results' => false来禁用缓存测试。

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