应显式执行 composer require vendor/package-name:1.2.3 --with-all-dependencies 强制降级，并清理 autoload 缓存及重启 php-fpm；composer 自身降级需重装指定版本 installer。
composer install 时用了错误版本，怎么立刻切回去
直接改 composer.json 里的版本约束，再跑 composer update 不一定生效——Composer 默认只更新满足约束的「最新可用」版本，不是你想要的那一个。
真正可控的方式是显式指定包名和目标版本：
- 先确认当前装的是哪个版本：
composer show vendor/package-name - 强制降级到某版：
composer require vendor/package-name:1.2.3 --with-all-dependencies -
--with-all-dependencies很关键：它让 Composer 同时调整依赖树里所有冲突的子依赖，否则容易卡在依赖不兼容报错
想全局降级 composer 自身（不是项目依赖）
很多人混淆了「Composer 工具本身」和「项目里用的 PHP 包」。如果你执行 composer --version 发现是 2.5.x，但需要退回 2.2.x（比如某些旧 CI 环境或插件不兼容），那就不是 require 能解决的。
正确做法是重新安装指定版本的 Composer 可执行文件：
- Linux/macOS：
curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer --version=2.2.22 - Windows（用 PowerShell）：
(Invoke-WebRequest -Uri https://getcomposer.org/installer).Content | php -- --install-dir=C:\bin --filename=composer --version=2.2.22 - 注意：
--version参数只对官方 installer 有效；用php composer.phar方式管理的，得手动下载对应composer-2.2.22.phar替换
composer update vendor/package 后锁文件没更新？
常见现象：composer update foo/bar 执行完，composer.lock 里对应的条目还是旧哈希，甚至 vendor/ 下文件根本没变。这通常是因为你漏掉了 --with-dependencies 或没处理平台配置冲突。
检查三件事：
- 确认
composer.json中该包的版本约束是否真的允许目标版本（比如写的是"^1.0"，但你想切到0.9.5，就不匹配） - 运行前加
-v查看详细日志：composer update foo/bar -v，留意有没有类似Skipping foo/bar (already at 1.2.3)的提示 - 如果项目启用了
platform.config（如"php": "8.1"），而目标版本不支持该 PHP 版本，Composer 会静默跳过——删掉config.platform.php临时测试一下
降级后 autoload 失效或 Class not found
这不是 Composer 本身的问题，而是 autoloader 缓存没刷新。Composer 2.2+ 默认启用 classmap 优化，降级后旧 classmap 可能还缓存着已删除的类路径。
必须连带清理两处：
- 删掉
vendor/composer/autoload_classmap.php（或整个vendor/composer/目录） - 运行
composer dump-autoload --optimize重建（别用--classmap-authoritative，除非你确认所有类都在 classmap 里） - 如果用了 OPCache，还得重启 PHP-FPM 或调用
opcache_reset()，否则即使文件更新了，PHP 还在用旧 opcode
最稳妥的组合操作是：rm -rf vendor/composer/autoload_*.php && composer dump-autoload && sudo systemctl reload php8.1-fpm（按实际 PHP 版本调整）
