唯一可靠降级方式是composer require vendor/package:1.2.3 --with-all-dependencies，它强制重装指定旧版本并同步调整所有冲突子依赖；直接改composer.json后运行update无效，因Composer默认只升不降。
composer require vendor/package:1.2.3 --with-all-dependencies 是唯一可靠降级方式
Composer 没有 downgrade 或 rollback 命令，所谓“降级”，本质是让 Composer 重新解析依赖并强制安装你指定的旧版本。直接改 composer.json 后跑 composer update 往往无效——它只升不降，除非你显式要求。
执行前先确认当前装的是什么版本：composer show vendor/package；再查历史可用版本：composer show -a vendor/package。
-
composer require vendor/package:1.2.3 --with-all-dependencies：这是最可控的操作，会同时调整所有冲突的子依赖，避免静默失败 - 别漏掉
--with-all-dependencies：否则 Composer 可能卡在子依赖不兼容处，报错却不说清哪一层出问题 - 如果提示
your requirements could not be resolved，运行composer why-not vendor/package:1.2.3查具体冲突来源 - 执行后
composer.lock会被重写，vendor/下文件也会替换，但 autoload 缓存不会自动刷新
composer update vendor/package 不会降级，除非约束允许
composer update 默认行为是“在当前约束范围内取最新可用版本”，不是“取你想要的版本”。如果你的 composer.json 里写的是 "vendor/package": "^2.3"，那它永远不可能装上 2.2.4。
- 先检查约束是否匹配目标版本：比如想退到
2.2.4，就得把^2.3改成2.2.4或~2.2.0，再执行composer update vendor/package - 加
-v参数看详细日志：composer update vendor/package -v，留意是否有Skipping vendor/package (already at 2.3.1)这类提示 - 注意
platform.config干扰：如果项目配置了"php": "8.2"，而你想降的包只支持 PHP 8.0，Composer 会静默跳过——临时删掉该配置再试
降级后 Class not found？autoload 缓存没清
版本显示正确、vendor/ 文件也替换了，但运行时报 Class 'Xxx\Yyy' not found，这不是包没装对，而是 autoloader 缓存还在用旧映射。
- 必须手动清缓存：
composer dump-autoload（开发环境）或composer dump-autoload --optimize（生产） - 如果用了 OPCache，还得重启 PHP 进程：
sudo systemctl reload php8.2-fpm或php-fpm reload - 某些 IDE（如 PhpStorm）会缓存类路径，关掉再重开项目更保险
- 不要靠删
vendor/autoload.php来“触发重建”——它只是入口文件，真正映射在vendor/composer/autoload_*.php里
composer self-update 2.5.8 是降级自身唯一推荐方式
区分清楚：“降级 Composer 工具本身”和“降级项目里的 PHP 包”是两件事。前者影响所有项目，后者只影响当前目录。工具降级只能用 self-update，不能靠 require。
- 执行
composer self-update 2.5.8（PowerShell 用户加引号：composer self-update "2.5.8"） - 别用
--rollback：它只回退上一个版本，且 v2.5.0+ 默认禁用，失败也不报错 - 如果提示
Permission denied，说明 Composer 装在系统目录，Linux/macOS 加sudo，Windows 用管理员权限运行终端 - 注意兼容性：v2.1.x 的
composer.lock格式与 v2.7 不兼容，若从高版本降下来，得先删掉composer.lock再composer install
最容易被忽略的是：Composer 自身版本和项目 lock 文件格式、PHP 版本要求、插件 API 都强耦合。一次降级可能牵出三处不兼容——锁文件解析失败、子依赖无法满足、甚至 PHP 运行时报错。动手前先看 composer --version 和 php -v 是否匹配目标版本的最低要求。
