WordPress页面循环报错：调用数组的have_posts()成员函数失败

嘿，我来帮你搞定这个报错！你遇到的Call to a member function have_posts() on array错误，本质原因很简单：你尝试在一个普通数组上调用只有WP_Query查询对象才有的have_posts()方法。大概率你是用了get_pages()函数来获取页面内容——它返回的是页面对象的数组，不是可直接用标准WordPress循环处理的查询对象。

下面给你两种靠谱的解决方案，按需选择：

方案1：用WP_Query构建自定义查询（推荐） #

这是WordPress官方推荐的自定义查询方式，返回的是标准查询对象，能直接用have_posts()和the_post()这类循环方法，代码更规范：

// 构建查询参数，获取所有发布状态的Pages
$project_query = new WP_Query(array(
    'post_type' => 'page',
    'post_status' => 'publish',
    'orderby' => 'date', // 按发布时间排序
    'order' => 'DESC',
    // 可以添加更多筛选条件，比如排除首页：'post__not_in' => array(get_option('page_on_front'))
));

// 标准WordPress循环
if ($project_query->have_posts()) {
    while ($project_query->have_posts()) {
        $project_query->the_post();
        // 这里输出你的项目内容，示例如下：
        ?>
        <article class="project-card">
            <h2 class="project-title"><?php the_title(); ?></h2>
            <?php if (has_post_thumbnail()) : ?>
                <div class="project-image"><?php the_post_thumbnail('medium'); ?></div>
            <?php endif; ?>
            <div class="project-excerpt"><?php the_excerpt(); ?></div>
            <a href="<?php the_permalink(); ?>" class="project-link">查看详情</a>
        </article>
        <?php
    }
    // 必须重置查询，恢复全局$post对象，避免影响后续博客文章的循环
    wp_reset_postdata();
} else {
    echo '<p>暂无项目可以展示</p>';
}

方案2：直接遍历get_pages()返回的数组 #

如果你已经习惯用get_pages()，也可以直接遍历返回的数组，手动处理内容输出：

// 获取Pages数组
$projects = get_pages(array(
    'post_status' => 'publish',
    'orderby' => 'date',
    'order' => 'DESC'
));

// 遍历数组输出内容
if (!empty($projects)) {
    foreach ($projects as $project) {
        // 手动设置当前文章对象，方便使用模板标签
        setup_postdata($project);
        ?>
        <article class="project-card">
            <h2 class="project-title"><?php echo get_the_title($project->ID); ?></h2>
            <?php if (has_post_thumbnail($project->ID)) : ?>
                <div class="project-image"><?php echo get_the_post_thumbnail($project->ID, 'medium'); ?></div>
            <?php endif; ?>
            <div class="project-excerpt"><?php echo apply_filters('the_excerpt', $project->post_excerpt); ?></div>
            <a href="<?php get_permalink($project->ID); ?>" class="project-link">查看详情</a>
        </article>
        <?php
    }
    // 同样要重置查询
    wp_reset_postdata();
} else {
    echo '<p>暂无项目可以展示</p>';
}

关键注意点 #

• 不管用哪种方案，最后一定要调用wp_reset_postdata()，它会把全局的$post对象恢复成原来的状态，防止后续的博客文章循环（Posts循环）出现异常。
• 如果需要筛选特定的Pages，可以在查询参数里添加include（指定页面ID）或者exclude（排除页面ID），或者结合页面分类/标签来筛选（需要先给Pages启用分类/标签功能）。

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