Laravel自定义异常报告_将异常发送到Sentry【操作】-php教程-PHP中文网

最稳妥方式是在app\exceptions\handler的report()中委托调用\sentry\laravel\eventhandler::report($exception)，同时保留parent::report($exception)以确保本地日志不丢失；需确认已安装sentry/sentry-laravel、正确配置sentry_laravel_dsn、清除配置缓存，并避免覆盖默认异常委托机制。

laravel自定义异常报告_将异常发送到sentry【操作】

如何在 Laravel 的 `App\Exceptions\Handler` 中集成 Sentry

直接修改 App\Exceptions\Handler 是最稳妥的接入方式，Laravel 9+ 默认已支持 report() 方法的异常委托机制，无需重写整个异常处理流程。

关键点是：不要覆盖 report() 原逻辑，而是用 Sentry\Laravel\EventHandler::report() 委托上报，同时保留 Laravel 原生日志（如本地开发时仍需看 storage/logs/laravel.log）。

确保已通过 composer require sentry/sentry-laravel 安装，并运行过 php artisan sentry:publish --force
检查 .env 中是否设置了 SENTRY_LARAVEL_DSN=...，空值或注释掉会导致静默失败

在 app/Exceptions/Handler.php 的 report() 方法中插入委托调用：

if (app()->bound('sentry')) {
    \Sentry\Laravel\EventHandler::report($exception);
}

别漏掉 use Sentry\Laravel\EventHandler;，否则会报 Class 'EventHandler' not found

为什么不能只依赖 `sentry/sentry-laravel` 的自动注册

自动注册（即不改 Handler）仅在未自定义 report() 时生效；一旦你重写了该方法（比如加了自定义日志逻辑），Sentry 的默认监听就会被跳过——这是 Laravel 异常委托机制决定的，不是 Sentry 插件的 bug。

常见错误现象：try { throw new \Exception('test'); } catch (\Exception $e) { report($e); } 在本地不报错、也不进 Sentry，就是因为 report() 被覆盖后没手动转发。

Laravel Creem Agent

Creem 支付商店助理 — 查询订阅、客户、交易、产品，执行心跳检查，管理本地 Laravel支付商店。

下载

自动注册本质是向 Laravel 的 ExceptionHandler 注册了一个 report 闭包，优先级低于你写的类方法
如果你用了 Log::error() 或 logger()->error() 手动记录异常，这些不会触发 Sentry 上报，必须走 report($e)
测试是否生效：临时在路由里写 throw new RuntimeException('sentry-test');，然后查 Sentry 控制台的「Recent Events」，别只看本地日志

`app('sentry')` 报 `Target class [sentry] does not exist` 怎么办

这个错误说明 Sentry 服务提供者没加载成功，通常发生在安装后没清缓存，或配置文件缺失。

执行 php artisan config:clear 和 php artisan cache:clear，Laravel 会重新扫描 config/app.php 中的 providers
确认 config/app.php 的 providers 数组里有 Sentry\Laravel\ServiceProvider::class（Laravel 5.5+ 一般自动发现，但升级或手动安装时可能遗漏）
检查 config/sentry.php 是否存在；如果不存在，说明 php artisan sentry:publish 没成功运行，或权限不足导致写入失败
若使用 Octane/Swoole，注意 Sentry 初始化时机：需在 bootstrap/app.php 中提前调用 \Sentry\init()，否则热重载下 app('sentry') 可能为 null

生产环境漏报异常？重点检查这三处

Sentry 不上报 ≠ 代码没跑，更可能是异常被吞掉、过滤掉、或网络卡住。比 DSN 写错更隐蔽的问题往往藏在这几个地方。

SENTRY_ENVIRONMENT 配置为空或与 Sentry 项目设置不一致，会导致事件被丢弃（尤其当项目启用了 Environment Filter）
config/sentry.php 中的 in_app_exclude 列表误加了 app/，结果所有业务异常都被标记为「第三方代码」而折叠
Laravel 的 ignore_exceptions 配置（在 app/Exceptions/Handler.php 的 $dontReport 属性）会阻止上报，比如 ValidationException 默认就在其中——如需上报，得手动从数组里删掉它