开发中碰上 PHP 框架报错，页面一片白，啥都不显示，挺常见。尤其在生产环境开了错误屏蔽，连个提示都没有，这时候光靠猜可不行，得有套路。
打开错误报告，先看清问题
本地调试第一件事，就是让错误显形。Laravel、ThinkPHP 这些主流框架都支持配置错误级别。比如 Laravel 的 .env 文件里把 APP_DEBUG=true 打开，错误堆栈立马就出来了。如果是自己搭的项目，记得在入口文件加上：
ini_set('display_errors', 1);
error_reporting(E_ALL);别小看这几句，很多时候一个拼写错误或未定义变量，直接就能定位。
善用日志，不只是看 error
框架的日志系统比 var_dump() 强太多。Laravel 写日志很简单：
\Log::info('用户登录尝试', ['user' => $userId, 'ip' => request()->ip()]);
\Log::error('数据库连接失败', ['exception' => $e->getMessage()]);日志不仅能记录异常，还能帮你追踪流程。比如某个订单状态没更新，翻日志发现根本没进那个方法，那问题可能出在路由或中间件上。
用 Xdebug 配合 IDE 设置断点
打印调试适合简单场景，复杂逻辑还是得上断点。装好 Xdebug 扩展后，在 PHPStorm 或 VSCode 里设个断点，请求一进来就会暂停，变量值、调用栈全都能看。
比如你怀疑某个服务类返回的数据不对，直接在方法开头打断点，一步步走，比反复刷新看输出高效多了。注意生产环境千万别开 Xdebug，性能损耗明显。
检查中间件和路由匹配
有时候代码没问题，但就是进不了控制器。这时候得查路由定义和中间件。Laravel 里运行 php artisan route:list 看路径是否注册正确。如果某个接口始终返回 401，可能是 auth 中间件提前拦截了，而你测试时没带 Token。
ThinkPHP 的模块绑定也容易出问题，访问 /admin/user 却跑到 index 模块，多半是路由规则写漏了。
模拟请求，绕过前端干扰
前端传参格式不对，比如把 JSON 写成 form-data，后端收不到数据。这种问题用 Postman 或 curl 直接发请求更干净：
curl -X POST http://localhost/api/v1/user \
-H "Content-Type: application/json" \
-d '{"name": "test", "email": "test@example.com"}'这样能快速确认是接口问题还是前端拼参问题。
关注变量作用域和依赖注入
在控制器里直接用 $this->userService，但如果这个属性没通过构造函数注入，运行时就会报错。Laravel 支持自动注入，但类型声明必须准确：
public function __construct(UserService $service)
{
$this->service = $service;
}少个 use 声明或者类名拼错，DI 容器就找不到对应实现。
调试不是碰运气，而是有步骤地缩小范围。从开启错误显示，到查日志、打点、模拟请求，每一步都在逼近真相。框架再复杂，也是人写的，出了问题总有痕迹可循。