高并发 laravel 应用中 sentry 需平衡上报准确性、性能开销与上下文保留：应分级采样（异常全量、追踪降为 5%）、确保异常穿透中间件与队列、精简上下文（禁用 pii、手动加关键标签）、按环境动态开关并过滤低价值错误。
在高并发 Laravel 应用中，Sentry 不是简单“装上就报错”，而是要兼顾上报准确性、系统性能开销、关键上下文保留三者平衡。盲目开启全量采样或默认配置，反而会导致 SDK 阻塞请求、漏报深层异常，甚至拖慢数据库连接池。以下是针对高并发场景的优化要点。
控制采样率，避免压垮 Sentry 或应用自身
高并发下每秒数百次错误上报会迅速耗尽 Sentry 配额，也容易因 SDK 同步发送阻塞 PHP 进程。必须分级设置采样策略：
-
错误事件（Exceptions）：生产环境建议设为
'sample_rate' => 1.0（全量），但仅限真实未捕获异常；对已知可恢复异常（如支付重复提交、库存不足）应主动ignore_exceptions过滤 -
性能追踪（Tracing）：必须降采样，例如
'traces_sample_rate' => 0.05（5% 请求），重点监控慢接口、高频队列任务和核心支付链路 -
队列任务追踪：启用
'queue_job_transactions' => true，但关闭'queue_jobs' => false（避免每个 job 都建 span），只对失败任务自动触发 transaction
确保异常能穿透中间件与队列，不被静默吞掉
高并发常见漏报原因不是 SDK 没装，而是异常在到达 Sentry 前已被拦截：
- Laravel 的
App\Exceptions\Handler::report()必须保留parent::report($exception)，否则自定义 handler 会中断上报链路 - 队列任务中，若使用
try/catch处理网络超时等可重试异常，需手动调用app('sentry')->captureException($e, ['extra' => ['job_id' => $this->job->getJobId()]])，不能依赖自动捕获 - API 接口里用
validate()抛出的ValidationException默认不进 Sentry，需在Handler::shouldReport()中显式放行，或统一在 Form Request 的failedValidation()中手动上报
精简上下文，只传真正影响定位的关键字段
每条错误附带完整用户 session、全部 request input 或大型 model 关联数据，会在高并发时显著增加序列化开销和网络传输延迟：
- 禁用自动注入敏感字段：在
config/sentry.php中关闭'send_default_pii' => false - 手动添加轻量上下文：例如在全局中间件中绑定当前租户 ID、订单号、请求来源渠道：
app('sentry')->configureScope(fn ($scope) => $scope->setTag('tenant_id', tenant()->id)); - 数据库异常特别处理：启用
MissingAttributeModelViolationReporter等模型监控器，比抓全量 SQL 更快定位 N+1 或属性误用问题
区分环境与流量层级，动态开关上报
开发/测试环境绝不允许上报，预发环境可开启低频采样用于压测验证：
-
.env中严格使用SENTRY_ENABLED=false控制开关，不要依赖环境名判断（APP_ENV=local不等于 Sentry 关闭） - 对高频读接口（如商品列表、搜索），可在中间件中临时禁用 Sentry：
app('sentry')->flush(); app('sentry')->getClient()->getOptions()->setDsn(null); - 通过
beforeSend回调过滤低价值错误：例如忽略Illuminate\Http\Client\ConnectionException中的 DNS 超时（属于基础设施问题，非业务逻辑缺陷）
