WP_Query无法返回自定义文章类型tlc_duck帖子问题排查

核心排查方向（针对注册代码31-40行） #

自定义文章类型注册的几个关键参数直接决定是否能被WP_Query查询到，重点检查：

• public 参数：必须设为 true，若为 false，该类型会被默认排除在所有公共/前端查询之外，即便后台和数据库可见。
• exclude_from_search 参数：需设为 false，若为 true，WP_Query默认不会包含该类型帖子。
• query_var 参数：需设为 true 或直接指定为 'tlc_duck'，该参数控制是否允许通过WP_Query的post_type参数查询到该类型。
• 注册钩子：必须通过 init 钩子注册，不能用 admin_init（仅后台生效）或 plugins_loaded（触发过早，初始化不完整）。

WP_Query代码（77-90行）检查点 #

即便注册没问题，查询参数错误也会导致无结果：

• 确认明确指定 'post_type' => 'tlc_duck'，注意拼写完全一致（WordPress自定义文章类型名称大小写敏感）。
• 检查 post_status：默认WP_Query仅查询 publish 状态的帖子，若新增的duck帖子是 draft/pending 状态，需添加 'post_status' => 'any' 测试。
• 避免全局查询污染：执行WP_Query后务必调用 wp_reset_postdata()，防止后续查询受影响；同时检查是否有 pre_get_posts 钩子修改了查询条件。

调试验证方法 #

• 打印生成的SQL语句：在WP_Query执行后，输出 $duck_query->request，直接到MySQL中执行，确认是否返回数据，快速定位是参数问题还是注册问题。
• 用get_posts快速测试：执行 var_dump(get_posts(array('post_type' => 'tlc_duck', 'post_status' => 'any')))，若返回空数组，可确定是注册参数问题。

正确注册代码示例 #

对比你的31-40行代码，确保关键参数正确：

add_action('init', 'register_tlc_duck_cpt');
function register_tlc_duck_cpt() {
    $args = array(
        'public'              => true,
        'label'               => 'Duck Posts',
        'query_var'           => true,
        'exclude_from_search' => false,
        'supports'            => array('title', 'editor'),
        'show_in_admin_bar'   => true,
    );
    register_post_type('tlc_duck', $args);
}

正确WP_Query示例 #

$duck_query = new WP_Query(array(
    'post_type'      => 'tlc_duck',
    'post_status'    => 'any', // 测试完成后可改为'publish'
    'posts_per_page' => -1, // 获取所有符合条件的帖子
));

if ($duck_query->have_posts()) {
    while ($duck_query->have_posts()) {
        $duck_query->the_post();
        // 输出帖子内容，比如 the_title()
    }
    wp_reset_postdata();
} else {
    error_log('No ducks');
}

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