开启错误报告并使用try-catch捕获异常，结合error_log记录日志、var_dump调试变量，通过浏览器开发者工具查看响应，配合Xdebug扩展实现高效调试，快速定位PHP接口错误来源。
调试 PHP 接口报错时，关键是快速定位错误来源并获取详细的错误信息。下面介绍几种实用的错误信息捕获与调试方法，帮助你高效排查问题。
开启错误报告显示
开发环境中应确保 PHP 显示所有错误，便于及时发现问题：
- display_errors = On：在 php.ini 中开启，让错误直接输出到页面
- error_reporting = E_ALL：报告所有级别的错误
也可以在脚本开头临时启用：
ini_set('display_errors', 1);
ini_set('error_reporting', E_ALL);
使用 try-catch 捕获异常
对于可能出现异常的操作（如数据库、API 调用），使用 try-catch 结构捕获并处理：
立即学习“PHP免费学习笔记（深入）”；
try {
// 可能出错的代码
$result = some_api_call();
} catch (Exception $e) {
error_log('接口异常: ' . $e->getMessage());
echo json_encode(['error' => '服务异常', 'detail' => $e->getMessage()]);
}
这样既能避免程序崩溃，又能将错误写入日志或返回前端用于调试。
记录日志追踪错误
使用 error_log() 或自定义日志函数记录关键信息：
- 请求参数：
error_log('请求参数: ' . print_r($_POST, true)); - SQL 执行语句及结果
- 第三方接口返回数据
建议将日志写入文件，方便后续分析，例如：
file_put_contents('debug.log', date('Y-m-d H:i:s') . ' - ' . $message . "\n", FILE_APPEND);
利用 var_dump 和 die 调试中间值
在关键位置插入 var_dump 查看变量内容：
var_dump($data); die;
适合快速查看某一步的执行结果，但上线前务必删除或注释。
结合浏览器开发者工具查看响应
通过浏览器 Network 面板查看接口返回状态码、响应头和响应体：
使用 Xdebug 提升调试效率
安装 Xdebug 扩展后，可实现：
- 更清晰的错误堆栈追踪
- 与 PhpStorm 等工具配合进行断点调试
- 性能分析和函数调用跟踪
配置后错误提示会包含文件、行号、调用层级，极大提升排查速度。
基本上就这些。关键是养成良好的日志习惯，合理使用工具，别依赖前端反馈来猜后端问题。
