常见原因有三类：扩展未安装、版本不匹配、环境用错；Swoole需PHP CLI下php --ri swoole显示≥5.0.0，RoadRunner需rr命令在PATH且≥2022.3。
php artisan octane:start 启动失败，常见原因是什么
启动失败基本就三类问题：扩展没装、版本不匹配、环境用错。Swoole 驱动下运行 php --ri swoole 必须显示 Version ≥ 5.0.0（Laravel 10+ 已弃用 Swoole 4.x）；RoadRunner 驱动则要确认 rr 命令在 $PATH 中，且版本 ≥ 2022.3（推荐 v2.15+）。别只看 phpinfo() —— Octane 走的是 CLI SAPI，必须用 php -m | grep swoole 或 which rr 验证。
config/octane.php 里哪几个参数直接影响稳定性
这三个值不是越大越好，设错反而拖垮服务：
-
'max_requests' => 1000：每个 worker 处理完 1000 个请求后自动重启，防内存泄漏；设为 0 表示永不重启，高并发下容易 OOM -
'worker_num' => 4：建议设为 CPU 核心数 × 1.5～2，超配会导致上下文切换开销激增 -
'task_worker_num' => 2：仅 Swoole 有效，用于异步任务（如发邮件、日志写入），但不能替代队列，别把它当 Horizon 用
Swoole 和 RoadRunner 在实际请求中表现差异在哪
性能数字接近，但行为逻辑完全不同：
Laravel Cloud
下载
Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。
- Swoole 是 PHP 扩展，所有逻辑在同一个进程内跑协程：
$_SERVER是只读快照，sleep()会阻塞整个 worker，opcache.preload效果更稳，适合需要 WebSocket 或自定义协程调度的场景 - RoadRunner 是 Go 进程管理器，PHP worker 通过 RPC 通信：
Log::info()默认输出到 stderr，得在.rr.yaml里配logs.output才能落盘；天然隔离，一个 worker 崩溃不影响其他，更适合容器化或混跑 HTTP + Queue
开发阶段优先试 RoadRunner：不用编译扩展，php artisan octane:install --server=roadrunner 就能跑；生产环境若已有 Go 运维能力，再切 Swoole 做深度调优。
为什么改了代码页面没更新，或中间件不生效
Octane 不支持 opcache.enable_cli=1 下的热重载，改完必须手动触发刷新：
- 改了路由或配置 → 先
php artisan config:clear && php artisan route:clear，再php artisan octane:reload - 改了中间件或控制器 → 同样要
octane:reload，--watch只监听文件变化，不自动清缓存 - 用了
config:cache或route:cache→ 必须在octane:start前生成，Octane 启动后改缓存文件无效
最常被忽略的是：octane:reload 不等于“热重载”，它只是向主进程发信号重启 worker，旧进程还在处理未完成请求，新逻辑要等这批请求结束才完全生效。
