PHP接口返回JSON失败主因是输出不纯净或JS请求格式不匹配PHP期望；需清除BOM/错误/缓冲并设正确header，JS须按Content-Type匹配$_POST或php://input读取。
PHP 后端接口返回数据不被 JS 正确解析
常见现象是 fetch 或 $.ajax 拿到响应后，response.json() 报错 Unexpected token，或 data 是空对象、undefined。根本原因往往是 PHP 没输出纯 JSON，夹杂了警告、Notice、BOM 头或 echo 了调试语句。
- 确保 PHP 接口开头调用
header('Content-Type: application/json; charset=utf-8'); - 关闭所有错误显示：
error_reporting(0); ini_set('display_errors', '0');（上线必须关，调试时也建议先关） - 用
ob_clean();清掉之前可能存在的输出缓冲，再调用echo json_encode($data, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES); - 最后加
exit;阻止后续代码执行（尤其避免框架自动渲染模板）
JS 发起请求时参数没传到 PHP $_POST 或 $_GET
典型表现：PHP 中 var_dump($_POST) 为空数组，但 JS 明明传了数据。问题不在 PHP，而在 JS 请求方式与 PHP 解析机制不匹配。
- 如果 JS 用
fetch+JSON.stringify()发送，后端不会进$_POST，得用file_get_contents('php://input')手动读原始体 - 想走
$_POST，JS 必须发application/x-www-form-urlencoded（如new URLSearchParams(data)）或multipart/form-data（如FormData） - GET 请求注意 URL 编码：中文或特殊字符必须用
encodeURIComponent()包裹，否则 PHP$_GET解析失败 - 检查 Apache/Nginx 是否限制了请求体大小（
client_max_body_size/post_max_size），超限会导致整个$_POST为空
Chrome DevTools 里 Network 面板看不出真实请求/响应
不是“看不到”，而是默认过滤或未触发。关键要确认三点：是否发起、是否被拦截、是否被缓存。
- 在 Network 面板左上角勾选
Preserve log，防止页面跳转后记录清空 - 右键表头 → 勾选
Size和Time，快速识别 204/304/Failed 请求 - 点击具体请求 → 查看
Headers标签页：确认Request Method、Request URL、Request Payload（非 Form Data）、Response内容是否符合预期 - 若响应是 HTML 而非 JSON，大概率是 PHP 报错直接输出了错误页面——此时看
Preview或Response标签页最直观
跨域请求被拦但控制台没报 CORS 错误
这种情况多见于预检请求（OPTIONS）失败，而浏览器只静默丢弃，不抛 JS 异常。JS 的 catch 捕获不到，Network 里却能看到一个失败的 OPTIONS 请求。
立即学习“PHP免费学习笔记（深入）”；
- PHP 端必须响应 OPTIONS 请求，并返回正确头：
Access-Control-Allow-Origin、Access-Control-Allow-Methods、Access-Control-Allow-Headers - 如果带 Cookie，还需加
Access-Control-Allow-Credentials: true，且前端fetch要设credentials: 'include' - 不要只在成功路径写 CORS 头——OPTIONS 请求通常不进业务逻辑，需单独处理，例如在入口文件开头判断
$_SERVER['REQUEST_METHOD'] === 'OPTIONS'并 exit - 开发阶段可临时用 Nginx 反向代理绕过跨域，比改 PHP 更可控
if ($_SERVER['REQUEST_METHOD'] === 'OPTIONS') {
header('Access-Control-Allow-Origin: http://localhost:3000');
header('Access-Control-Allow-Methods: GET, POST, OPTIONS');
header('Access-Control-Allow-Headers: Content-Type, X-Requested-With');
header('Access-Control-Allow-Credentials: true');
exit;
}
实际调试中，90% 的交互问题出在“PHP 输出不干净”或“JS 请求格式和 PHP 期望不一致”这两点。别急着查文档，先看 Network 里的原始请求体和响应体——那才是唯一真相。 
