PHP API返回JSON为空需检查数据准备、响应头设置和输出干扰三环节：确认$data非空且正确编码，设置Content-Type为application/json，清除BOM/错误输出等干扰，并验证HTTP状态码与前端解析逻辑。
PHP API返回JSON为空，通常不是代码“没输出”，而是数据没正确生成、没正确发送，或前端没正确接收。重点检查三个环节：数据准备是否为空、响应头是否设对、输出过程是否被干扰。
检查PHP脚本是否真有数据可输出
很多情况下，json_encode() 输入的是空数组、null 或查询失败的 false，导致输出空字符串或 null。
- 在
json_encode()前加var_dump($data); exit;确认变量内容 - 数据库查询后，用
if (!$result || $result->num_rows === 0)判断是否有数据，避免对空结果调用fetch_all() - 如果用 PDO，注意
fetch()返回 false 时别直接 json_encode，应统一转成空数组：$data = $stmt->fetch() ?: [];
确认响应头（Content-Type）已正确设置
没设 Content-Type: application/json 不影响 JSON 内容本身，但部分前端（如 Axios、Fetch）会因 MIME 类型不匹配而拒绝解析，表现为“空响应”或解析错误。
- 在输出 JSON 前加上：
header('Content-Type: application/json; charset=utf-8'); - 确保这行代码在任何输出（包括空格、BOM、echo、warning）之前执行，否则会报 “headers already sent” 错误
- 用浏览器开发者工具的 Network → Response Headers 栏确认该 header 是否存在
排查输出被意外截断或覆盖
常见干扰源：开启的错误报告输出、UTF-8 BOM、意外 echo/print、输出缓冲未清理。
立即学习“PHP免费学习笔记（深入）”；
- 临时关闭错误显示：
error_reporting(0); ini_set('display_errors', '0');（上线环境本就该关） - 用编辑器检查 PHP 文件是否含 UTF-8 BOM（尤其 Windows 记事本保存的文件），改用 VS Code 或 Notepad++ 保存为 “UTF-8 无 BOM”
- 检查是否有未注释的调试语句（如
echo "debug";）、多余空行，或 include 的文件末尾带换行/空格 - 保险起见，输出前加
ob_end_clean();清掉已有缓冲区
验证返回结果是否被前端误判
有时后端已正常返回 JSON 字符串，但前端因跨域、状态码非200、或解析逻辑问题，把它当作“空”处理。
- 直接在浏览器地址栏访问 API URL，或用 curl：
curl -i http://your-api.com/data.php，看原始响应体和状态码 - 检查 HTTP 状态码是否为 200；如果是 500、404 或 400，JSON 内容再对也白搭
- 前端用
response.text()而非response.json()先看原始响应字符串，确认是不是真的空，还是解析时报错
