最近排查一个后台接口问题，PHP 返回的数据在浏览器里看着没问题，接口状态也是 200，但前端一直提示“请求失败”。最开始以为是前端判断写错了，后来把接口原始响应打印出来，才发现真正的问题是返回 JSON 前面多了一段 Warning。

这个项目里有个公共文件负责读取配置，其中一个字段不存在时触发了 PHP 警告。页面直接访问接口时，肉眼看到后面的 JSON 是正常的，但前端调用 response.json() 时，前面只要多出一行 Warning、Notice，整个响应就已经不是合法 JSON 了，所以解析直接失败。

后来处理时没有简单把错误显示全部关掉，而是把问题分成两部分。开发环境保留错误日志，方便及时发现变量、数组下标和类型问题；正式环境关闭错误直接输出，统一写入日志文件。接口层则固定设置 application/json，并通过统一方法返回数据，避免某个文件不小心 echo、var_dump 或输出调试内容。

这种问题在 PHP 项目里非常常见，特别是老系统升级 PHP 版本以后。以前能正常运行的代码，换到新版本可能会多出 Warning 或 Deprecated，页面看起来只是多几行提示，但接口一旦被小程序、前端框架或者第三方系统调用，就可能直接变成解析失败。

所以现在做接口排查时，我不会只看 HTTP 状态码，还会直接检查原始响应内容。接口“请求成功”和“数据格式正确”其实是两回事。

#PHP开发 #接口开发 #JSON解析 #程序排查