WordPress have_posts()返回false，页面内容无法显示

看起来你已经做了不少常规操作还是没解决，我来帮你一步步深挖可能的原因：

先确认最基础的配置问题 #

• 检查页面状态：确保所有出问题的页面都是发布状态，不是草稿、私密或者已删除到回收站的。有时候误操作改了状态自己没留意。
• 检查页面模板：有没有给这些页面指定了自定义模板？如果自定义模板的循环逻辑有问题或者根本没写循环，自然显示不出内容。可以临时把页面模板切换回「默认模板」试试。

检查当前代码及主查询状态 #

你的循环代码是WordPress标准写法，但有可能主查询已经被之前的代码干扰了：

• 先排查是否有其他查询篡改了主查询：如果在这段循环代码之前，有使用query_posts()或者自定义WP_Query但没重置，会导致主查询失效。可以在循环前添加wp_reset_query();来恢复主查询，再测试：

<?php
wp_reset_query(); // 先重置主查询
if ( have_posts() ) : 
    while ( have_posts() ) : the_post(); 
        get_template_part( 'parts/content', 'page' ); 
    endwhile; 
else : 
    get_template_part( 'parts/content', 'missing' ); 
endif; 
?>

• 添加调试代码查看主查询详情：在循环前加入这段代码，看看主查询到底有没有获取到页面数据：

<?php
global $wp_query;
echo '<pre>';
print_r($wp_query); // 输出主查询的所有参数和结果
echo '</pre>';
?>

重点看post_count和found_posts这两个值，如果都是0，说明主查询确实没查到内容；如果有数值，那问题可能出在get_template_part调用的模板文件上（比如parts/content-page.php不存在或者逻辑错误）。

主题与插件冲突排查 #

• 切换默认主题：临时把当前主题换成WordPress官方默认主题（比如Twenty Twenty-Four），如果页面内容能正常显示，那就是当前主题的代码有问题（比如pre_get_posts钩子错误过滤了页面查询）。
• 禁用所有插件：全部禁用后刷新页面，如果恢复正常，再逐个启用插件，每启用一个就测试一次，找到导致冲突的插件。很多SEO、缓存类插件可能会修改查询逻辑引发这类问题。

极端情况：数据库数据异常 #

如果以上方法都没用，那可能是数据库里的页面数据出了问题：

• 登录phpMyAdmin，找到wp_posts表（前缀可能不是wp_，看你的配置），检查出问题的页面对应的记录：确保post_type是page，post_status是publish，post_parent符合你的页面层级设置。

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