FrankenPHP 是 Laravel Octane 中最轻量、开箱即用的服务器，仅需 PHP ≥ 8.1；启动失败主因是未执行 php artisan octane:install --server=frankenphp 或权限/环境问题；Swoole/FrankenPHP 下须避免 $_SERVER 静态依赖、队列需独立运行、静态变量易致内存泄漏。
FrankenPHP 是目前 Laravel Octane 中最轻量、开箱即用的服务器选择，尤其适合本地开发和中小型生产部署；它不需要额外安装 PHP 扩展（如 Swoole），也不依赖外部二进制（如 RoadRunner 的 rr），只要 PHP ≥ 8.1 就能直接跑起来。
FrankenPHP 启动失败：找不到 frankenphp-worker.php 或报错 command not found
Octane 安装 FrankenPHP 时会自动下载二进制并生成 worker 脚本，但这个过程容易被跳过或中断：
- 必须先执行
php artisan octane:install --server=frankenphp，不能只跑composer require laravel/octane就以为完事了 - 如果项目已有
vendor/bin/frankenphp-worker.php但权限不足，运行chmod +x vendor/bin/frankenphp-worker.php - 某些 CI/CD 环境或 Docker 构建中，
octane:install下载步骤会被静默跳过——检查vendor/bin/frankenphp是否存在且可执行（ls -l vendor/bin/frankenphp） - Windows 用户需确认已启用 WSL2，原生 Windows 不支持 FrankenPHP（Go 编译的二进制无 Windows 版）
Swoole 模式下请求卡住或返回空白：别碰 $_SERVER 和 $_GET
Swoole 是常驻内存模型，$_SERVER 在首次请求后就“冻结”为快照，后续请求不会更新。直接读取会导致路由错乱、参数丢失、HTTPS 判断失效等问题：
- 把所有
$_SERVER['REQUEST_URI']替换为request()->fullUrl()，$_SERVER['REQUEST_METHOD']替换为request()->method() - 避免在
bootstrap/app.php或服务提供者register()方法里做基于请求头的逻辑（比如根据Host动态切换配置） - 中间件里若需判断是否 HTTPS，用
request()->secure()，而不是检查$_SERVER['HTTPS'] === 'on' - 重载代码必须用
php artisan octane:reload，不要kill -USR1，否则 Swoole 可能复用旧的$_SERVER快照
队列不执行、事件没广播：Octane 不管队列生命周期
php artisan octane:start 只接管 HTTP 请求，它不会启动、监听或转发队列任务。常见表现是任务写进数据库但一直 pending，或者 broadcast(new XxxEvent) 看似成功却没推送到前端：
立即学习“PHP免费学习笔记（深入）”；
- 队列必须单独运行：用
php artisan queue:work --once配合 Supervisor，或 Laravel 10+ 推荐的php artisan queue:listen（注意不是--daemon，该选项已弃用） - 确认
BROADCAST_DRIVER不是log，生产环境至少设为redis或pusher - 如果你用
sync驱动，任务会同步阻塞当前 HTTP 请求 —— 这在 Octane 下等于拖垮整个 Worker，务必禁用 - 定时任务（
scheduler）同样独立，仍需php artisan schedule:run每分钟触发一次
内存缓慢增长最终 OOM：静态变量跨请求污染
这是 Octane 最隐蔽也最致命的问题。Swoole/FrankenPHP Worker 复用进程，全局静态变量、单例容器绑定、手动缓存（如 static $cache = []）会在多次请求间累积，最终耗尽内存：
- 删掉所有类中类似
private static $data = [];的缓存写法，改用Cache::remember()或请求级依赖注入 - 避免在服务提供者
boot()中对单例绑定做状态修改（例如$this->app->singleton('foo', fn() => new Foo($someGlobalState))） - 数据库连接、Redis 客户端等资源要确保每次请求获取新实例，或显式调用
disconnect()；Laravel 默认的persistent连接在 Swoole 下极易堆积空闲连接 - FrankenPHP 相对友好，但仍有风险 —— 它虽不共享 PHP 进程，但每个 worker 内部仍是常驻的，静态变量照样跨请求
FrankenPHP 的优势在于免扩展、免配置、HTTP/3 原生支持，但它不解决 Octane 的根本矛盾：PHP 的“一次性请求”心智模型与常驻内存之间的冲突。真正难的从来不是启动命令，而是把所有隐式依赖请求上下文的代码，都改成显式、可销毁、无状态的写法。
