PHPStorm调试时异常默认不中断，必须手动启用PHP Exception Breakpoints并勾选Any exception或指定类，且需确保Xdebug连接正常、端口匹配、未被set_exception_handler拦截，断点触发于throw语句而非catch块。
PHPStorm 调试时，未处理的异常默认不会中断执行——必须手动启用异常断点，否则它只会返回 500 或静默失败。
PHPStorm 中必须勾选 PHP Exception Breakpoints
PHPStorm 不像 VS Code 那样默认监听异常，它需要显式开启“异常断点”功能，否则 throw new Exception() 会直接穿透到 set_exception_handler 或 500 页面，调试器完全不介入。
- 打开
Run → Breakpoints…（或快捷键Cmd+Shift+F8/Ctrl+Shift+F8） - 切换到
PHP Exception Breakpoints标签页 - 勾选
Any exception（捕获所有Throwable），或只勾选具体类如Exception、PDOException、TypeError - 确保
Suspend模式为All（而非Thread），避免多线程下漏停 - 注意：该设置是项目级的，换项目需重新确认
为什么 catch 块里断不住，而 throw 行才停
PHPStorm 的异常断点触发位置是 throw 语句本身，不是 catch 入口。这是设计使然，目的是定位“异常源头”，而非“处理位置”。如果你在 catch 里加了普通行断点却没触发，大概率是因为异常已被上层 try-catch 吞掉，根本没传到你这层。
- 检查调用栈是否被中间层提前捕获（比如框架的全局中间件、控制器基类）
- 若想强制停在
catch，请在catch第一行手动加普通断点，而非依赖异常断点 -
catch (Throwable $e)能覆盖ParseError等，但 PHPStorm 异常断点对ParseError无效——它属于编译阶段错误，Xdebug 无法拦截
Xdebug 配置必须匹配 PhpStorm 监听端口
即使勾选了异常断点，如果 Xdebug 没连上 PhpStorm，断点也永远不会生效。常见失效原因是端口不一致或连接被拒绝。
立即学习“PHP免费学习笔记（深入）”；
- 确认
php.ini中启用了xdebug.mode=debug和xdebug.client_port=9003（PHPStorm 默认监听 9003） - 检查
xdebug.client_host是否指向宿主机 IP（Docker 环境下不能写127.0.0.1，应写宿主机真实 IP 或host.docker.internal） - 在 PhpStorm 中打开
Run → Start Listening for PHP Debug Connections，确保小电话图标为绿色 - 访问页面时 URL 必须带
XDEBUG_SESSION_START=PHPSTORM参数，或浏览器插件已激活
入口文件顶部注册 set_exception_handler 会干扰异常断点
如果你在入口文件（如 index.php）顶部写了 set_exception_handler()，那么未被捕获的异常会直接进这个处理器，绕过 PHPStorm 的异常断点机制——因为 Xdebug 在异常被“抛出后、被全局处理器接管前”才有机会中断。
- 开发调试期间，建议暂时注释掉
set_exception_handler调用 - 若必须保留，可在处理器内部加
debug_print_backtrace()或error_log()辅助定位，但它不能替代断点 - 更稳妥的做法是：把
set_exception_handler放在路由分发之后、业务逻辑之前，避开框架初始化等早期异常
真正容易被忽略的是：异常断点只对“运行时抛出”的 Throwable 生效，对语法错误（ParseError）、扩展缺失（Fatal error: Class 'Redis' not found）完全无感——这些得靠 php -l 或错误日志查行号。
