spatie/laravel-webhook-client 安装失败主因是版本不兼容：v2.x 仅支持 laravel 9/10 和 php ≥8.0，laravel 8 及以下需用 ^1.14；配置未生成需手动 publish --force；签名失败多因 payload 被框架处理失真，须用 php://input 获取原始字节流。
composer require spatie/laravel-webhook-client 装不上？先确认 Laravel 版本兼容性
这个包目前（v2.x）只支持 Laravel 9 或 10，如果你用的是 Laravel 8 或更早版本，composer require spatie/laravel-webhook-client 会报依赖冲突——不是你命令写错了，是它根本没为旧版 Laravel 提供适配分支。
- 运行
php artisan --version确认当前 Laravel 大版本 - Laravel 8 及以下：只能用已归档的 v1.x（如
composer require spatie/laravel-webhook-client:^1.14），但注意它不支持 Laravel 的新式 HTTP client 和中间件注册方式 - v2.x 要求 PHP ≥ 8.0，Laravel ≥ 9.0，且依赖
spatie/webhook-server的底层能力，不能降级混用
webhook-client 配置文件没生成？手动发布后别忘改 config/webhook-client.php
执行 php artisan vendor:publish --provider="Spatie\WebhookClient\WebhookClientServiceProvider" 后，配置文件不会自动写入 config/ 目录——它只在首次发布时生成，如果之前执行过、或项目里已有同名文件，Composer 就会跳过。
- 检查
config/webhook-client.php是否存在；不存在就再跑一次 publish 命令加--force - 关键字段必须填：比如
'signing_secret' => env('WEBHOOK_SIGNING_SECRET')，漏掉会导致签名验证失败，所有请求被拒 -
'name' => 'my-webhook'这个键名要和路由定义里的 name 一致，否则WebhookClient::for('my-webhook')找不到配置
收到 Webhook 却没进 HandleWebhookJob？检查中间件和路由绑定
默认情况下，包只注册一个 POST 路由，路径是 /webhooks/{name}，但不会自动加 CSRF 排除——如果用了 VerifyCsrfToken 中间件，所有外部请求都会 419。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 在
app/Http/Middleware/VerifyCsrfToken.php的$except数组里加上'webhooks/*' - 确保路由定义在
routes/api.php（而非web.php），因为外部服务通常不带 session cookie - 别直接在控制器里写逻辑：包靠
HandleWebhookJob异步处理，你要做的只是继承它并重写handle方法，否则 webhook 会被当成普通请求丢给框架，不走验证也不进队列
签名验证总失败？重点盯 X-Hub-Signature-256 和原始 payload
很多平台（GitHub、Stripe、Shopify）发来的签名是基于原始二进制 payload 计算的，而 Laravel 默认会把请求 body 当字符串解码、过滤不可见字符——哪怕只多一个换行或空格，hash_hmac('sha256', $payload, $secret) 就对不上。
- 在路由闭包或控制器里，用
file_get_contents('php://input')拿原始字节流，别用$request->getContent()或$request->all() - 确认 Header 名：GitHub 用
X-Hub-Signature-256，Stripe 用Stripe-Signature，包里要对应配置'signature_header_name' - 测试时用
curl -H "X-Hub-Signature-256: sha256=..." -d '{"event":"test"}' http://localhost:8000/webhooks/my-webhook，别用 Postman 自动格式化 body
最常卡住的地方其实是签名比对前的数据“失真”——你以为传进去的是原始 payload，其实框架已经 trim 过、json_decode 过、甚至 utf8_encode 过。抓包看 raw request body，再和代码里实际参与 hash 的字符串做 hexdump 对比，差一个字节都白忙。
