laravel无内置长连接心跳路径，推荐用nginx直接返回204响应；若需php处理，应单独定义无中间件的get路由如/api/heartbeat并显式排除认证等中间件。
Laravel 本身不直接提供“长连接心跳包路径”的内置机制，因为 HTTP 是无状态短连接协议，真正的长连接（如 WebSocket、SSE 或自定义 TCP 连接）需借助第三方服务（如 Laravel Echo + Socket.IO、Swoole、或 Laravel Reverb）。但很多项目会用“伪心跳”方式——即客户端定期发起轻量 HTTP 请求（如 /api/heartbeat）来维持会话活跃、检测连接状态或触发保活逻辑。这类请求需要被精准识别、快速响应、绕过耗时中间件，因此路径过滤规则很关键。
心跳路径应独立且可识别
必须让心跳请求走一条最简路径，避免经过认证、日志、验证等中间件。推荐做法是：
- 单独定义一个无状态、无权限要求的 GET 路由，例如：
Route::get('/api/heartbeat', fn() => response()->noContent())->name('heartbeat'); - 不挂载任何中间件（包括
auth:sanctum、throttle、validate等），确保毫秒级响应。 - 路径命名清晰（如
heartbeat），便于 Nginx/CDN 层做路由分流或监控标记。
在 Kernel 中显式排除心跳路径
若你已在全局中间件中启用了会话、CSRF 或认证（如 $middleware 数组里有 \App\Http\Middleware\Authenticate::class），这些中间件会对所有请求生效。此时需在中间件内部做路径白名单判断：
- 在
app/Http/Middleware/Authenticate.php的handle()方法开头加入：if ($request->is('api/heartbeat')) { return $next($request); } - 同理，对日志中间件、性能监控中间件也做类似判断，避免写入无效日志或触发采样统计。
Nginx 层提前拦截（推荐）
真正高效的保活不应依赖 PHP 层处理。可在反向代理层直接响应心跳：
location = /api/heartbeat {
return 204;
add_header X-Heartbeat "alive";
}
这样请求根本不会到达 Laravel，零 PHP 开销，延迟最低，也规避了所有框架层过滤逻辑的不确定性。
避免用动态参数或通配符匹配心跳
不要写成：
Route::get('/api/{any}', ...)->where('any', '.*'); // ❌ 易误伤，且破坏路由优先级
也不要依赖 Route::fallback() 处理心跳 —— fallback 是兜底行为，执行顺序靠后，中间件已全部加载完毕，失去“轻量”意义。
不复杂但容易忽略
