如何查看Laravel中自定义异常类的触发与捕获情况【说明】
验证自定义异常需三步：确认异常是否被抛出（检查命名空间与类名后缀），验证report()是否正确记录，确认render()是否按预期响应。务必注意请求类型判断、事务回滚与日志配置等常见卡点，确保异常处理流程完整性。
验证自定义异常这件事，说起来其实不复杂，但很多人习惯一上来就翻日志、打断点，结果绕了一大圈还没找到问题。要想确认自定义异常类有没有被正确触发和捕获，重点不在于“翻日志”或者“打小断点”，而是分三步来验证：它有没有被抛出来、有没有被 report() 记录、有没有被 render() 处理。每一步都对应一个可以观察、可以验证的具体行为。
第一步：看看它有没有真正被抛出来
自定义异常必须明确地 throw 出去，而且类名必须以 Exception 结尾，否则 PHP 是不认的，instanceof 判断也会直接失效。这里有几个常见坑需要注意：
- 检查抛出处有没有用
use AppExceptionsYourCustomException;引入命名空间，如果没有，PHP 会找不到这个类，抛出一个静默失败或者直接报Class not found错误。 - 千万不要直接写
throw new Exception('xxx')—— 这种写法无法被instanceof YourCustomException捕获，等于白抛。 - 一个简单的验证方法：在抛出位置加一句
Log::debug('About to throw YourCustomException');，然后去storage/logs/lara vel.log看看这行日志有没有出现。出现了，说明执行到了抛出点；没出现，那就是前面的条件没满足。
第二步：查 report() 有没有把它记录下来
report() 是异常进入日志系统的入口。默认情况下，所有没有被 $dontReport 排除的异常都会被记录，但你也可以主动控制。实际操作时，可以这样做：
- 打开
app/Exceptions/Handler.php，在report()方法开头加一句：if ($exception instanceof YourCustomException) { Log::warning('Custom exception caught in report', ['msg' => $exception->getMessage()]); } - 然后触发一下这个异常（比如调用一个会抛该异常的接口），再运行
tail -n 20 storage/logs/lara vel.log，搜索Custom exception caught in report。 - 如果没看到，说明异常根本没走到
report()—— 要么是被$dontReport列表屏蔽了，要么是在抛出前就被其他try/catch给吞掉了。
第三步：验 render() 是否按预期响应
render() 决定了用户最终能看到什么。API 请求应该返回 JSON，Web 请求可以返回视图，但有一点必须注意：不能绕过父类的逻辑。具体操作如下：
- 在
render()中对应处理分支里加一行：Log::info('Rendering YourCustomException response'); - 发起请求（建议用
curl -H "Accept: application/json"模拟 API 调用），然后查日志确认这条 log 有没有出现。 - 检查 HTTP 状态码和响应体是否符合预期。比如你抛了
new YourCustomException('No money', 402)，那就应该返回状态码 402 和对应的 JSON，而不是 500 或 HTML 页面。 - 另外，务必保留
return parent::render($request, $exception);在最后——漏掉这句，框架内置的异常处理（比如 404、验证失败）也会失效。
快速定位常见卡点
很多时候，问题其实卡在细节上，比如请求类型判断错了、异常被中间件提前吞掉了、或者日志通道配置不对。以下几个点值得格外留意：
$request->expectsJson()在中间件中可能不太可靠，改用$request->is('api/*')会更稳妥。- 事务内抛了异常却没回滚？检查一下是否用了
DB::transaction()闭包，而且内部没有加try/catch静默处理。 - 日志没写进
lara vel.log？确认config/logging.php中'default' => env('LOG_CHANNEL', 'daily')设置没问题，而且磁盘有写权限。 - 开发环境看不到堆栈？确认
APP_DEBUG=true，并且没有在config/app.php的debug_blacklist里误删了关键变量。
正软商城本月促销专区，汇集办公、设计、安全、影音、系统工具及AI软件等正版软件优惠活动，提供限时折扣、特价授权和优惠购买信息，活动库存及价格以页面实时展示为准。
正软商城装机必备专区，精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件，帮助用户快速完成新电脑软件配置。
正软商城Windows软件专区，汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件，提供软件介绍、系统要求、正版授权及购买下载服务。
正软商城macOS软件专区，精选适用于Mac电脑的办公、设计、影音、效率、开发和系统工具，提供软件功能介绍、macOS兼容版本、正版授权及购买下载服务。
正软商城iOS软件专区，精选适用于iPhone和iPad的办公、学习、影音、设计、效率及AI应用，提供功能介绍、适用设备、系统要求和正版获取方式等信息。
正软商城AI软件专区，汇集AI写作、AI绘画、AI视频、AI办公、AI编程、AI翻译、智能客服和数据分析等人工智能工具，提供功能介绍、适用平台、收费方式及正版购买信息。
正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法，同时介绍常用PDF软件和工具的使用技巧。
赤友清理大师是一款为 Mac 设计的智能清理优化工具，可精准扫描垃圾、大文件、重复文件等，释放磁盘空间。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
极度公式是一款跨平台专业LaTeX公式识别编辑软件，支持OCR公式识别和多平台编辑。和使用说明，避免使用，享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
一款文字处理软件，一种订阅式的跨平台办公软件，基于云平台提供多种服务，通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合，Office 365 可让任何人使用任何设备随时随地创建和共享内容。
CodeExpander 是一款快捷短语输入增强工具，通过键入缩写自动展开为自定义文段，提升工作效率。任务管理和过程控制会更完整，持续下载、批量同步或需要稳定传输流程的场景会更适合它。
Mountain Duck 是一款能将多个网盘挂载到本地的工具，像本地磁盘一样使用网盘。清理链路的完整性会更好一些，做应用卸载、残留处理和空间整理时，通常能少走很多手动排查步骤。
极度公式是一款跨平台专业LaTeX公式识别编辑软件，支持OCR公式识别和多平台编辑。和使用说明，避免使用，享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
一款文字处理软件，一种订阅式的跨平台办公软件，基于云平台提供多种服务，通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合，Office 365 可让任何人使用任何设备随时随地创建和共享内容。
Wise Folder Hider Pro 是一款专业级文件和文件夹隐藏加密软件，为私密数据添加多重保护。高频操作更强调就近处理，浏览、整理和跨目录移动文件时，来回切换和重复点击都会少很多。
CodeExpander 是一款快捷短语输入增强工具，通过键入缩写自动展开为自定义文段，提升工作效率。任务管理和过程控制会更完整，持续下载、批量同步或需要稳定传输流程的场景会更适合它。
Mountain Duck 是一款能将多个网盘挂载到本地的工具，像本地磁盘一样使用网盘。清理链路的完整性会更好一些，做应用卸载、残留处理和空间整理时，通常能少走很多手动排查步骤。
