必须启用mercure hub且php需生成合法jwt：前端eventsource订阅需带subscriber_jwt签名的bearer token，发布需publisher_jwt签名的token，主题url须字节级一致。
Mercure Hub 必须启用，且 PHP 代码里不能漏掉 JWT 签发逻辑
FrankenPHP 实现站内通知实时提醒，核心就是用它内置的 Mercure Hub，而不是自己搭 WebSocket 或轮询。但很多人配完 Caddyfile 就以为万事大吉，结果前端 EventSource 一直连不上，或者连上了却收不到推送——问题往往出在 JWT 签发环节没做，或密钥不一致。
为什么 EventSource 连不上 / 401 错误
Mercure 订阅不是裸连，客户端必须带有效的 JWT（由 subscriber_jwt 密钥签发）才能建立 SSE 连接。Caddyfile 里写了 subscriber_jwt，但 PHP 后端没生成这个 token，前端就拿不到合法凭证。
- 前端订阅 URL 必须带
Authorization: Bearer <token></token>，不能只写new EventSource('/.well-known/mercure?topic=...') - PHP 里要用
openssl_sign()或firebase/php-jwt生成 token，payload 至少含mercure字段（如{"mercure": {"subscribe": ["https://example.com/notifications"]}}） - 密钥必须和 Caddyfile 中
subscriber_jwt完全一致（包括换行、空格），建议用base64_decode()处理后传入签名函数 - Caddy 的 Mercure 模块默认只允许 HTTPS 订阅；开发时若用
localhost，需在 Caddyfile 加insecure指令
PHP 后端怎么发通知（publisher 流程）
通知内容不是由 PHP 直接“推”给浏览器，而是 POST 到 Mercure Hub 的 /.well-known/mercure 端点。FrankenPHP 提供了 frankenphp.WithMercureHub() 注入的实例，但你得自己构造 HTTP 请求。
- 发布请求必须带
Authorization: Bearer <publisher_token></publisher_token>，token 用publisher_jwt密钥签发，payload 至少含mercure字段（如{"mercure": {"publish": ["https://example.com/notifications"]}}） - 推荐用 cURL 而非 Guzzle：FrankenPHP 的 worker 进程对长连接敏感，Guzzle 可能复用连接导致超时；cURL 显式设
CURLOPT_TIMEOUT_MS = 200更稳妥 - 主题 URL 必须和前端订阅的完全一致（协议、域名、路径、尾部斜杠），
https://example.com/notifications和https://example.com/notifications/是两个不同 topic - 不要在 HTTP 响应中同步发通知；应放入异步队列（如 Symfony Messenger + Redis transport），避免阻塞请求
前端如何稳定接收并避免重连风暴
浏览器原生 EventSource 对网络抖动很敏感，断开后默认立即重试，容易触发 Caddy 的速率限制（默认 10 次/秒），导致后续连接被 429 拒绝。
- 手动控制重连间隔：监听
onerror，用setTimeout延迟重建EventSource，首次失败等 1s，第二次等 2s，指数退避到 30s 封顶 - 每个用户只建一个
EventSource实例，别在 React 组件 mount 时无条件 new，要用 useRef 缓存 - 服务端推送的数据必须是标准 Mercure 格式：
data: {"message":"新订单","type":"order"}+event: notification+ 空行，不能省略event:行 - Chrome 和 Safari 对
EventSource的最大并发数有限制（通常 6 个），别为每个通知类型开独立连接，统一用一个 topic，靠event字段区分类型
最容易被忽略的是主题 URL 的一致性——从 PHP 构造 topic 字符串、Caddyfile 配置、前端订阅 URL、发布请求里的 topic，四者必须字节级相同。差一个斜杠、协议写成 http 而非 https，都会静默失败，且 Mercure Hub 默认不打日志，得手动加 debug 指令才能看到拒绝原因。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
