Swoole 下仅用 --optimize-autoloader 不够，必须在 onWorkerStart 中重置 PSR-4 映射、禁用 files 自动加载并避免 --classmap-authoritative；否则将导致类找不到、重复定义和内存泄漏。
不能靠 --optimize-autoloader 单独解决，必须配合启动时机控制、映射重置和加载隔离 —— 否则类找不到、重复定义、内存泄漏会直接发生。
为什么 Swoole 下 composer install --optimize-autoloader 不够用
优化后的 autoload_classmap.php 是静态快照，但 Swoole Worker 进程常驻后不会重新执行 vendor/autoload.php。一旦你热更新类文件或改了命名空间，classmap 仍指向旧路径；而 PSR-4 fallback 又被 --classmap-authoritative 关闭，结果就是 Class not found 且无回退路径。
- Worker 重启（如
max_request触发）不重建 autoloader 实例，只复用启动时的$loader对象 -
files类型脚本（如全局函数注册）在每个 Worker 的onWorkerStart中重复执行，可能造成Cannot redeclare function - 开发期用
inotify热重载时，若没手动调用$loader->setPsr4()清空并重设映射，新类永远不生效
必须在 onWorkerStart 中重置 PSR-4 映射
不是“加个参数就行”，而是要在 Swoole 启动逻辑里显式干预 Composer 的加载器状态。默认 autoload 机制把映射写死在 $loader->prefixesPsr4 里，进程常驻后它就冻结了。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 启动前（
Swoole\Server::start()前）先调用$loader->setPsr4([])清空旧映射 - 在
onWorkerStart回调中，重新调用$loader->setPsr4($newMapping)，确保每次 Worker 初始化都拿到当前磁盘上最新的命名空间配置 - 如果用了
inotify监听文件变更，$newMapping应从实时扫描结果生成，而非读取vendor/composer/autoload_psr4.php（该文件不会随热更自动更新）
禁用 files 自动加载，改由 onWorkerStart 按需包含
第三方包（比如 Laravel Octane 兼容层、Swoole bridge）常在 composer.json 的 "files" 字段里注册全局函数或 register_shutdown_function。这些代码在每个 Worker 启动时都会执行一遍，极易引发资源抢占或信号 handler 冲突。
- 检查
vendor/composer/autoload_files.php，确认哪些包写了files条目 - 在
composer.json中移除对应包的"files"配置，或 fork 后删掉 - 把原
files脚本里的逻辑抽出来，在onWorkerStart中显式require_once，并加判断避免重复加载（例如用function_exists()包裹）
别信 --classmap-authoritative 在 Swoole 环境下的“提速”宣传
它强制关闭 fallback，看似快，实则把问题藏得更深：类名拼错、命名空间末尾少反斜杠、目录大小写不一致，全都会变成静默的 Class not found，错误堆栈还不会提示真实位置。
- 仅当满足全部条件时才可启用：
no-dev+ 所有类严格符合 PSR-4 + 无files加载 + 无运行时动态类生成 - Swoole 场景下，热更新是刚需，而
--classmap-authoritative和热更互斥——你不可能每次改完类都 reload 整个服务 - 真正省时间的是减少
stat()调用，但 PHP 7.4+ 的 opcache 已缓存文件路径，classmap 的收益远不如保证映射实时性来得关键
最易被忽略的一点：Swoole 的 reload_async 或 max_request 重启 Worker，不会触发 vendor/autoload.php 重执行，也就不会刷新任何 autoload 状态。所有“优化”动作，必须落在 onWorkerStart 这个生命周期钩子里，而不是部署命令行参数上。
