WordPress多次查询自定义文章致single.php ACF字段失效如何优化为单次查询

你遇到的字段失效问题本质由两个原因导致：

1. 自定义get_posts循环未调用wp_reset_postdata()，全局$post变量被infos自定义文章类型的数据覆盖，后续single页面的原生主查询、ACF字段读取都会获取到错误的$post对象，最终字段读取失效。
2. 重复执行查询造成不必要的数据库请求，额外消耗性能。

通过WordPress钩子提前执行一次查询，把需要的联系信息存储到全局变量或对象缓存中，header、footer直接调用缓存数据即可，全程仅执行一次数据库查询。

步骤1：在主题functions.php中添加提前查询逻辑 #

// 提前预加载infos类型联系信息，全局模板均可调用
function preload_contact_info() {
    // 调用对象缓存避免重复查询，即使函数被多次触发也只会查询一次数据库
    $contact_info = wp_cache_get('site_contact_info', 'custom_theme');
    if (false === $contact_info) {
        $posts = get_posts(array(
            'numberposts' => -1,
            'post_type' => 'infos',
            'no_found_rows' => true, // 跳过分页计数，进一步优化查询速度
        ));
        $contact_info = [];
        foreach ($posts as $p) {
            // 直接传入文章ID获取字段，全程不污染全局$post变量
            $contact = get_field('contact', $p->ID);
            if ($contact) {
                $contact_info[] = $contact;
            }
        }
        wp_cache_set('site_contact_info', $contact_info, 'custom_theme', 3600); // 缓存有效期1小时，可自行调整
    }
    // 定义全局变量供模板直接调用
    global $site_contact;
    $site_contact = $contact_info;
}
add_action('after_setup_theme', 'preload_contact_info');

步骤2：header.php、footer.php直接调用已缓存数据 #

不需要再重复写查询逻辑，直接遍历全局变量输出内容即可：

<?php 
global $site_contact;
foreach ($site_contact as $contact) :
?>
<a href="tel:<?= esc_attr($contact['tel']) ?>"><?= esc_html($contact['tel']) ?></a>
<?php endforeach; ?>

如果不想调整全局逻辑，也可以通过以下方法快速修复原有代码的失效问题：

• 每次自定义循环结束后立刻调用wp_reset_postdata()重置全局$post对象，即可解决single页面字段失效问题
• 调用get_field时主动传入文章ID参数get_field('contact', $post->ID)，不依赖可能被污染的全局$post变量

• 所有输出的用户提交字段都要添加转义函数：普通文本内容用esc_html()，标签属性值用esc_attr()，链接地址用esc_url()，避免XSS安全风险
• 如果infos类型仅存在1篇文章，可将查询参数中的numberposts改为1，无需遍历全部内容，进一步优化性能

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