本文详解为何使用 ob_start() + ob_get_contents() + exit($content) 组合会导致 AJAX 返回内容重复两次，并提供两种简洁可靠的修复方案。
本文详解为何使用 `ob_start()` + `ob_get_contents()` + `exit($content)` 组合会导致 ajax 返回内容重复两次，并提供两种简洁可靠的修复方案。
在 WordPress 或其他 PHP 后端场景中，通过 AJAX 加载模板片段（如
）是常见需求。但开发者常遇到一个看似诡异的现象：前端 console.log(response) 显示同一段 HTML 被返回了两次，例如：<div class="live-ajax-messages">message from deep ajax</div> <div class="live-ajax-messages">message from deep ajax</div>
根本原因在于 PHP 输出缓冲机制与 exit() 的交互行为被误解。
当你执行以下代码时：
public function get_ajax_messages_template() {
ob_start(); // 开启输出缓冲
include(__DIR__. '/../templates/search-results-messages.php'); // 输出被暂存至缓冲区
$content = ob_get_contents(); // 获取缓冲内容，但——缓冲区未清空！
exit($content); // 1️⃣ 输出 $content；2️⃣ 然后自动 flush 缓冲区 → 再次输出相同内容！
}ob_get_contents() 仅「读取」当前缓冲区内容，不会清除它。而 exit($content) 在输出 $content 的同时，会触发 PHP 的默认响应结束流程——包括自动 flush() 当前输出缓冲区。结果就是：内容被输出两次。
立即学习“PHP免费学习笔记（深入）”；
✅ 正确解法一：用 ob_get_clean() 替代 ob_get_contents()
public function get_ajax_messages_template() {
ob_start();
include(__DIR__. '/../templates/search-results-messages.php');
$content = ob_get_clean(); // ✅ 读取并清空缓冲区
exit($content); // 此时缓冲区已空，仅输出一次
}✅ 正确解法二（推荐）：彻底避免冗余缓冲，直出模板
既然目标就是把模板内容原样返回，无需中间捕获处理，最简洁、高效且不易出错的方式是跳过输出缓冲：
public function get_ajax_messages_template() {
include(__DIR__. '/../templates/search-results-messages.php');
exit(); // ✅ 无参数 exit()，仅终止脚本，无额外输出
}⚠️ 注意事项：
- 不要混用 ob_get_contents() 与 exit($string) —— 这是重复输出的典型陷阱；
- 若后续需对模板内容做字符串处理（如正则替换、动态注入），再考虑 ob_get_clean()；
- 在 WordPress AJAX 处理函数中，务必调用 wp_die() 或 exit 结尾，防止意外输出额外空白或 PHP Notice 影响 JSON/HTML 响应格式；
- 前端 AJAX 应确保 dataType: 'html' 与后端纯 HTML 输出一致，避免 MIME 类型不匹配导致解析异常。
总结：PHP 输出缓冲是强大工具，但需明确各 ob_* 函数的行为差异。ob_get_clean() 是安全读取+清空的原子操作；而“不需要缓冲就不用缓冲”，往往是更健壮的工程实践。
