多线程下composer自动加载出问题，是因为php不支持真正多线程，而多进程并发读写vendor/autoload.php或classmap文件会导致类定义冲突或加载失败；正确做法是构建与运行环境分离、vendor只读、autoload仅初始化一次，并启用--classmap-authoritative优化。
为什么多线程下 Composer 自动加载会出问题
PHP 本身不支持真正的多线程（如 pthreads 或 pcntl_fork 后的共享内存），但当多个进程（比如并发的 CLI 命令、Web 请求、或 Swoole/Workerman 的 worker 进程）同时修改或读取 vendor/autoload.php 生成的类映射时，就可能触发类定义冲突。典型现象是：Fatal error: Cannot declare class X, because the name is already in use 或 Class not found 却又在 get_declared_classes() 里存在——本质是不同进程/线程加载了同一类的不同版本（比如因 composer dump-autoload --optimize 期间文件写入未完成，或 classmap 缓存被并发覆盖）。
这不是 Composer 的 bug，而是它默认不考虑跨进程状态同步。尤其在 CI/CD 构建后直接部署、或容器内多 worker 共享 vendor 目录时，风险更高。
composer dump-autoload 必须加 --no-dev 和 --optimize 吗
不是必须，但生产环境强烈建议。不加 --optimize 时，ClassLoader 依赖 findFile() 动态遍历 psr-4 映射，每次类加载都涉及多次 file_exists() 和 stat()，在高并发下容易因文件系统缓存不一致导致路径判断偏差；而 --optimize 生成的 classmap.php 是静态数组，加载快且无竞态。
-
--no-dev能缩小 classmap 尺寸，避免 dev-only 类（如phpunit）被意外加载引发命名冲突 - 务必搭配
--classmap-authoritative：它让 autoloader 完全信任 classmap，跳过文件存在性检查，杜绝“找不到却声明过”的中间态 - 执行命令示例：
composer dump-autoload --no-dev --optimize --classmap-authoritative
多进程部署时 vendor/ 目录不能共享
即使用了 --classmap-authoritative，如果多个 PHP 进程（如 Nginx + PHP-FPM 多 worker、Swoole 多 worker）共用同一份 vendor/，且该目录由某个进程在运行时执行了 composer install 或 dump-autoload，就会产生写入竞争——autoload_classmap.php 可能被截断或写入一半，其他进程加载时直接 fatal。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
正确做法是把构建和运行环境彻底分离：
- 构建阶段（CI/CD 或本地打包）完成
composer install --no-dev和dump-autoload，生成完整、只读的vendor/ - 运行时挂载或复制该
vendor/到容器/服务器，确保权限为read-only（Linux 下可用chown -R root:root vendor && chmod -R 555 vendor） - 禁止任何运行时执行
composer命令（包括require动态加载）
Swoole/Workerman 中 require autoload.php 的时机很关键
在常驻内存的协程/worker 模型中，如果每个请求都重新 require 'vendor/autoload.php'，而该文件内部又做了全局状态初始化（比如注册 spl_autoload_register），会导致重复注册、autoload chain 混乱，最终类加载行为不可预测。
必须保证 autoload 只初始化一次：
- 主进程启动时（如
Server::start()前）加载vendor/autoload.php - worker 进程 fork 后不再重复 require —— 因为
ClassLoader实例已继承，且classmap数组在内存中是共享副本 - 若使用
Composer\Autoload\ClassLoader手动实例化，请确保单例，不要在每个请求中 new 一个
最容易被忽略的是：某些框架封装了自动加载逻辑（如 Laravel 的 Illuminate\Foundation\Bootstrap\LoadConfiguration），在 worker 重启时可能再次触发 autoload 初始化。这类代码需要 patch 或绕过。
