composer本身不支持自动扩缩容，它仅负责依赖安装与自动加载；扩缩容必须由外部基础设施（如k8s、swoole worker）基于指标触发，php任务包只提供无状态、可并发的执行单元。
Composer 本身不支持自动扩缩容，别往 composer.json 里塞调度逻辑
直接在 Composer 包里实现“自动扩缩容”是常见误解。Composer 只负责拉代码、装依赖、生成 autoloader——它不启动进程、不监听指标、不调用 docker compose scale 或 kubectl scale。所谓“用 Composer 封装调度器”，本质是把调度器的 SDK、任务定义、执行器胶水代码打包成可复用的包，交由外部系统（如 Swoole Worker、XXL-Job 执行器、K8s Job Controller）驱动。
典型错误是：在 composer require myorg/task-scheduler 后，期望运行 php artisan schedule:run 就能自动增减 worker 实例。这不可能——PHP CLI 进程无法跨机器创建容器或 Pod。
- 真正起作用的是你部署时启动的长期运行进程（如
php start-worker.php），不是 Composer 安装动作 -
composer.lock是唯一能保证各节点加载相同任务类和接口版本的依据，但不参与运行时决策 - 若包中硬编码了
exec('docker compose scale worker=5')，属于严重设计缺陷：权限越界、环境耦合、不可测试
任务包必须实现标准接口并声明 PSR-4 自动加载
调度器（如 XXL-Job SDK、Swoole Task Server）靠反射加载任务类。如果类找不到，报错是 Class "AppJobOrderTimeoutJob" not found，不是“扩缩容失败”。
你的 Composer 包 myorg/order-jobs 的 composer.json 必须含：
{
"autoload": {
"psr-4": {
"App\Job\": "src/Job/"
}
}
}
且类文件路径严格匹配：
-
src/Job/OrderTimeoutJob.php→ 命名空间AppJobOrderTimeoutJob - 必须实现统一接口，例如
TaskInterface::execute(array $params)，不能各自为政 - 禁止在构造函数里 new Redis()；改用
$this->redis = $container->get('redis')或$_ENV['REDIS_DSN']
扩缩容决策必须外移，Composer 包只提供可伸缩的执行单元
自动扩缩容的触发点永远在基础设施层：CPU 使用率、队列积压数、HTTP 延迟等。PHP 任务包只需保证单个实例能快速启动、无状态、可并发执行。
正确分工：
- ✅ Composer 包提供：
AppJobInventoryCheckJob类、预设的重试策略、结构化日志上下文 - ✅ 外部系统做：
if (queue_length > 1000) { exec('kubectl scale deploy/worker --replicas=8'); } - ❌ 错误做法：在
InventoryCheckJob::execute()里读取 Prometheus 数据并调用扩容 API
原因：任务执行时间应尽可能短（毫秒级），而扩缩容是分钟级操作；混在一起会导致任务超时、重复触发、状态混乱。
生产部署必须用 composer install --no-dev --prefer-dist --optimize-autoloader
边缘节点资源紧张，autoloader 性能直接影响任务冷启动速度。未优化的 PSR-4 加载可能让单个任务多花 20–50ms。
-
--no-dev：排除phpunit、phpstan等，减少 vendor 体积与扫描路径 -
--prefer-dist：用压缩包而非 git clone，解压快、IO 少 -
--optimize-autoloader：生成vendor/composer/autoload_classmap.php，O(1) 查类，非 O(n) 遍历目录 - 务必运行
composer check-platform-reqs—— 缺ext-swoole或 PHP 版本不对，worker 进程根本起不来
CI 流水线生成新 composer.lock 后推送到所有节点；严禁在生产机跑 composer update。
真正难的不是写一个能跑的任务类，而是让一百台异构边缘节点，在网络抖动、磁盘满、扩展缺失时，仍能加载同一份任务逻辑——这全靠 composer.lock 和干净的 autoloader 配置兜底。
