composer安装spatie/laravel-webhook-server失败主因是laravel版本不匹配：laravel 8需用^2.9，9+用v3.x（php 8.2+）；装完class not found需手动注册服务提供者；dispatch失败多因队列未启用或签名验证失败。
composer require spatie/laravel-webhook-server 装不上？先确认 Laravel 版本兼容性
这个包只支持 Laravel 9.x 及以上（Laravel 8 需用 v2.10.0 以下旧版），装不上大概率是版本不匹配。运行 composer show laravel/framework 看当前版本，再查 spatie/laravel-webhook-server 的 composer.json 中 "laravel/framework": "^9.0|^10.0|^11.0" 这类约束。
- 如果你用 Laravel 8，必须指定旧版：
composer require spatie/laravel-webhook-server:^2.9 - Laravel 11 用户注意：v3.x 默认要求 PHP 8.2+，PHP 8.1 会报错
Your requirements could not be resolved - 别直接复制教程里的最新版命令——很多博客没更新兼容说明
装完后 Webhook::create() 报 Class not found？服务提供者没注册
新版 Laravel（9.2+）默认启用 Package Discovery，但某些情况（比如你禁用了 extra.laravel.dont-discover 或改过 config/app.php）会导致 Spatie\WebhookServer\WebhookServerServiceProvider 没自动加载。
- 手动加到
config/app.php的providers数组末尾：Spatie\WebhookServer\WebhookServerServiceProvider::class - 运行
php artisan config:clear，否则缓存会掩盖注册失败 - 验证是否生效：执行
php artisan vendor:publish --provider="Spatie\WebhookServer\WebhookServerServiceProvider"，如果提示 “Copied File” 就说明识别到了
dispatchWebhook() 发不出去？检查队列驱动和重试配置
这个包默认把 Webhook 当作队列任务发（WebhookCall 实现了 ShouldQueue），如果队列没跑、或失败后没重试，请求就静默丢弃了。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 确保
QUEUE_CONNECTION不是sync（开发时容易忽略），否则不会进队列，但也不会报错 - 查看失败任务表：
failed_jobs里有没有WebhookCall相关记录，常见原因是目标 URL 无法访问或 SSL 验证失败 - 临时调试可强制同步执行：
WebhookCall::create()->url('https://httpbin.org/post')->payload(['test' => 1])->dispatchNow() - 注意
retry_after默认是 90 秒，若你的 Webhook 接口响应慢，可能被队列系统误判为失败
自定义签名头（X-Hub-Signature-256）验签失败？别漏掉 verify_signature 配置
包默认开启签名验证（verify_signature => true），但 Laravel 的中间件默认不解析原始请求体，导致 hash_hmac('sha256', $body, $secret) 算出来的值和 Header 对不上。
- 在
config/webhook-server.php里确认'verify_signature' => true，且'signature_header_name' => 'X-Hub-Signature-256' - 关键一步：确保接收 Webhook 的路由用的是
web中间件组（它包含Illuminate\Http\Middleware\ConvertEmptyStringsToNull等），而不是纯 API 路由——API 中间件默认跳过 body 解析逻辑 - 测试时用
curl -H "X-Hub-Signature-256: sha256=xxx" -d '{"a":1}' http://localhost/webhook，别用 Postman 自动加 Content-Type，容易触发 Laravel 的 JSON 解析覆盖原始 body
最常卡住的地方其实是队列没启、签名验不过、或者 Laravel 版本和包版本硬顶上了。配好之后，先跑通 dispatchNow()，再切回队列，比对着文档一行行猜快得多。
