答案是composer why-not vendor/package:version可精准定位阻塞链，输出为倒序依赖链，从根声明向上追溯每级(required by)约束来源；输出为空时需检查require-dev或版本号格式错误。
直接看 composer why-not 输出，别猜。迁移后冲突绝大多数源于旧依赖链卡死某个版本，不是新包本身有问题。
先定位谁在封杀目标版本
报错里出现 don’t install vendor/package:version（比如 don’t install guzzlehttp/guzzle:^7.5），立刻执行对应命令：
-
composer why-not guzzlehttp/guzzle:^7.5—— 输出是倒序依赖链，从最后一行（你composer.json的根声明）往上读，每行末尾的(required by ...)就是上一级约束来源 - 如果输出为空，检查是否写错版本号（漏了
:、用了未发布的版本），或冲突来自require-dev—— 它不会出现在根声明里，但会悄悄拉低依赖版本 - 常见隐形卡点：
phpunit/phpunit锁死sebastian/exporter，间接拖住symfony/console；laravel/sanctum要求illuminate/support ^10.0，而你项目还卡在 Laravel 9
验证真实依赖结构，别信 composer.json 里的“愿望清单”
composer show --tree 显示的是 vendor/ 和 composer.lock 的真实快照，不是你写的理想状态：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 用
composer show --tree | grep "symfony/console"看是否标着(locked to 5.4.42) - 过滤关键路径：
composer show --tree monolog/monolog | grep -A5 -B5 "guzzlehttp/guzzle"，确认是不是某条路径在强制降级 - 看到
(replaced)或(provided)标记？得去那个包自己的composer.json查replace字段，确认是否真能等价替代
升级或降级单个包必须带 --with-dependencies
composer update vendor/package 默认拒绝更新其子依赖，哪怕新版本根本跑不起来——这是最常踩的坑：
- 升版本：
composer update monolog/monolog --with-dependencies，只动它和直系依赖 - 降主版本（如从
guzzlehttp/guzzle:^8.0切回7.4.5）：必须先在composer.json里写死"guzzlehttp/guzzle": "7.4.5"，再跑composer update guzzlehttp/guzzle --with-dependencies - 错误写法：
composer update "monolog/monolog:^3"—— 引号 +^会让 Composer 自己找“最新兼容版”，不是你要的3.0.0 - 执行后立刻
git diff composer.lock，确认只有目标包及其直系依赖被改
PHP 版本不匹配时别用 --ignore-platform-reqs
报错 requires php ^8.1 but your PHP version (7.4.33) does not satisfy that requirement，说明当前 shell 的 php -v 和 composer.json 中的 "php": "^8.1" 不一致：
- Linux/macOS：用目标二进制直接调用，例如
/usr/bin/php8.1 composer install - Windows：用完整路径，例如
"C:\php\php81\php.exe" composer install -
config.platform.php只适用于极少数场景：你在 PHP 7.4 开发机上为 PHP 8.2 生产环境提前打包；CI 流水线中明确指定目标环境且所有包已验证兼容 - 禁用场景更关键：本地 PHP 是 7.4，却设
"platform": {"php": "8.2"}后直接跑 Laravel 11 ——match、readonly、命名参数等语法在 7.4 里根本不存在
真正难处理的不是报错本身，而是 require-dev 里藏着的旧测试工具链，它们往往比主依赖更顽固。每次迁移后，先 composer why-not 一个核心运行时包（比如 symfony/http-kernel），比盲目 update 有效得多。
