PHP JSON接口调试核心是“看清请求、抓准响应、定位问题”，需验证PHP输出是否为合法JSON、用curl/Postman模拟真实请求、分段打印中间值、通过浏览器开发者工具抓包分析。

PHP JSON接口调试核心是“看清请求、抓准响应、定位问题”。重点不在写代码，而在验证数据流向是否符合预期。

检查PHP端JSON输出是否规范

很多问题其实出在PHP返回的不是合法JSON。用json_last_error()和json_last_error_msg()立刻验证：

• 确保header('Content-Type: application/json; charset=utf-8')已设置，避免浏览器误解析
• 不要在json_encode()前后拼接HTML、空格或BOM字符（常见于UTF-8 with BOM编码的PHP文件）
• 若返回数组含中文，确认PHP文件本身是UTF-8无BOM格式，且未被意外echo/print_r干扰

用curl或Postman模拟真实请求

浏览器直接访问GET接口容易掩盖问题，尤其POST/PUT需带Body时：

Json Schema Toolkit

使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。

下载

• Postman中选择对应Method，填URL，在Body → raw → JSON中输入合法JSON，并勾选Content-Type: application/json
• 命令行用curl测试： curl -X POST -H "Content-Type: application/json" -d '{"name":"张三"}' http://localhost/api/user.php
• 注意：PHP中读取原始JSON需用file_get_contents('php://input')，而非$_POST（后者只处理表单编码）

在PHP中打印关键中间值

别只看最终输出，分段确认每一步是否如你所想：

立即学习“PHP免费学习笔记（深入）”；

• 打印$_SERVER['REQUEST_METHOD']确认请求类型
• 对POST请求，先var_dump(file_get_contents('php://input'))看原始体是否收到
• 解码后立刻检查$data = json_decode($raw, true)是否为null（可用json_last_error()进一步判断原因）
• 返回前用echo json_encode($response, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT)让结果可读

浏览器开发者工具抓包分析

前端调用失败时，F12打开Network标签页，点开对应请求：

• 看Status是否为200；若为500，说明PHP执行出错，查服务器错误日志（error_log或php_errors.log）
• Preview/Response里查看实际返回内容——常发现是PHP警告混在JSON前（如“Notice: xxx”），导致JSON解析失败
• Headers里确认Content-Type确实是application/json，且没有多余换行或空格