直接运行composer require guzzlehttp/guzzle即可安装，但失败主因是php版本不匹配（guzzle 7需≥7.2.5、8需≥7.4）、缺失curl扩展或依赖冲突；需用php -v、php -m | grep curl检查环境，用composer why和depends --tree定位阻塞依赖，php 8.1+必须升至^7.5修复初始化bug。
直接运行 composer require guzzlehttp/guzzle 就能装上，但多数报错不是命令写错了，而是 PHP 版本、扩展或依赖树卡住了——得先查清拦路的是谁，再动手。
装不上 guzzlehttp/guzzle？先看 PHP 和 cURL
Guzzle 7.x 要求 PHP ≥ 7.2.5，Guzzle 8.x 起最低要 PHP 7.4；低于这个版本，composer require 会直接失败，报 “Your requirements could not be resolved”，而不是提示版本问题。同时它强依赖 curl 扩展，没启用的话，装完也跑不起来，发请求时抛 GuzzleHttp\Exception\ConnectException，错误里带 “cURL error 1” 或 “could not resolve host”。
- 检查 PHP 版本：
php -v - 检查 cURL 是否启用：
php -m | grep curl - Ubuntu/Debian 上启用：
sudo apt install php-curl，然后重启 PHP-FPM 或 CLI 环境 - PHP 7.1 或更低？只能退到
guzzlehttp/guzzle:^6.5（LTS 已停更，仅限救急）
Class 'GuzzleHttp\Client' not found？autoload 没引对
装完没报错，但 new \GuzzleHttp\Client() 就崩，八成是没正确引入 Composer 自动生成的自动加载文件。这不是 Guzzle 的问题，是项目启动链漏了一环。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 确保在使用前执行了：
require 'vendor/autoload.php'; - 路径必须准确：脚本不在项目根目录时，用
require __DIR__ . '/vendor/autoload.php'; - 别把
composer.json当加载器——它只管配置，不负责加载类 - 如果改过 autoload 配置，可手动重建：
composer dump-autoload
装了却报版本冲突？用 composer why 和 depends --tree
最常见冲突来源是旧版 Laravel、Symfony 组件，或另一个 HTTP 客户端（如 php-http/httplug）锁死了低版本 guzzlehttp/guzzle。Composer 不会绕开约束，只会报错。
- 查谁依赖了 Guzzle：
composer why guzzlehttp/guzzle - 看完整依赖树卡在哪一层：
composer depends --tree guzzlehttp/guzzle - 若只是开发调试用，可加
--dev装：composer require guzzlehttp/guzzle --dev - 真要升级，优先删掉
composer.json里硬写的"guzzlehttp/guzzle": "6.5.*"这类限制，换成"^7.5"再重试
PHP 8.1+ 下 new GuzzleHttp\Client() 就崩？别用 ^7.0
这是 Guzzle 7.2 及更早版本在 PHP 8.1 的严格属性初始化检查下触发的 bug，现象是刚实例化就报 Typed property must not be accessed before initialization，尤其在用了自定义 handler 或 mock 时。
- 修复方式明确：必须升到
guzzlehttp/guzzle:^7.5或更高（7.5.0是第一个彻底修复该问题的版本） - 别用
^7.0、~7.2或7.4.*—— 这些在 PHP 8.1+ 上不可靠 - 若项目被 Laravel 8 锁死（默认带 7.2.x），需在
composer.json中显式覆盖："guzzlehttp/guzzle": "^7.5"，再composer update
真正容易被忽略的是：Guzzle 不是“装完就能用”的扩展，它的行为高度依赖构造参数（比如 timeout、verify、http_errors），而这些默认值在不同版本间有实质性变化。不设 timeout 可能导致脚本无限 hang，不设 http_errors => false 会让 4xx/5xx 直接炸掉逻辑流——这些都不是报错，而是静默失效。
