Octane 需满足底层扩展、配置校验和启动验证三重条件才生效；仅 composer require 不启用，须运行 octane:install 并正确配置 driver；PHP 版本≥8.0 且扩展/二进制匹配；更新依赖后必须 stop→install→start。
Octane 不是“装上就能加速”，它依赖底层扩展、配置校验和启动验证三重生效条件，漏掉任意一环都会静默退化为普通 HTTP 服务。
composer require laravel/octane 后必须运行 octane:install
只执行 composer require laravel/octane 并不会启用 Octane——它只是把包放进 vendor/，没生成配置、没下载二进制、没改 server.php 入口。必须紧接着运行：
-
php artisan octane:install --server=swoole（需已启用swoole扩展） -
php artisan octane:install --server=roadrunner（会尝试下载rr二进制）
国内网络下 octane:install --server=roadrunner 常卡在下载 rr，可提前手动下载对应平台的 rr 二进制（如 rr-v2.4.5-linux-amd64），重命名为 rr，放项目根目录并执行 chmod +x rr，再重试命令。
driver 配置拼写错误会导致静默 fallback 到 HTTP 服务
打开 config/octane.php，看到 'driver' => 'swoole' 就以为生效了？不一定。Octane 启动时只检查扩展是否存在，不校验字符串值是否合法：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 填了
'driver' => 'sw00le'（多零）或'driver' => 'roadrumer'（拼错），它不会报错 - 而是直接跳过，用内置的 PHP 内置服务器兜底，性能毫无提升
- 验证方式：启动后看终端第一行输出，必须含
Starting Swoole Server或Starting RoadRunner Server，否则 driver 没生效
Octane 启动前必须确保 PHP 扩展和版本匹配
Laravel Octane 要求 PHP >= 8.0，且对应驱动有硬性依赖：
- Swoole 需要
ext-swoole（v5.0+ 推荐），运行php -m | grep swoole确认 - RoadRunner 不依赖 PHP 扩展，但要求
rr二进制与系统架构匹配（Linux AMD64 / macOS ARM64 等） - PHP 版本不匹配时，
octane:start可能直接退出无提示，检查php -v和composer.json中"config": {"platform": {"php": "8.1.0"}}是否冲突
部署时 composer install 后必须重启 Octane 服务
Octane 是常驻内存进程，composer install 或 dump-autoload 不会自动重载类映射：
- 生产环境更新依赖，必须先
php artisan octane:stop - 再执行
composer install --no-dev --optimize-autoloader --classmap-authoritative - 最后
php artisan octane:start - 切勿在 Octane 运行中执行
composer update，可能引发类加载冲突或 fatal error
最容易被忽略的是 --classmap-authoritative：它让 autoloader 完全信任 classmap，跳过文件系统扫描，在 Octane 下能避免热重载时找不到新类的问题。
