Composer require失败本质是依赖约束无解，需用composer prohibits或why-not定位冲突源，结合-vvv查看平台限制与镜像配置。
Composer require 失败不是“装不上”，而是“算不出解”——它已经穷举了所有可能的版本组合，但没找到一组能同时满足所有约束的方案。
报错 Your requirements could not be resolved 怎么定位冲突源头
这是 SAT 求解器明确告诉你：依赖图里存在不可调和的约束。别急着删 vendor 或 composer.lock，先用 Composer 自带的诊断命令挖根。
- 运行
composer prohibits vendor/package:version，它会直接列出谁在阻止你装这个包（比如laravel/framework 10.42.0要求symfony/console ^6.2，而你试图装的包只兼容^5.4） - 执行
composer why-not vendor/package:version，输出更具体：哪一行requires、哪个已安装包在反向绑定旧版 - 加
--dry-run -v看composer update卡在哪一步，错误行里通常带 “cannot be installed because…” —— 那就是冲突第一现场
require 后装成 dev-main 或低版本，不是网络问题，是约束被压垮了
你写的是 composer require monolog/monolog:^3.0，结果装了 dev-main，说明项目里已有某个依赖（比如 phpunit/phpunit）只认 monolog:^2.0，Composer 只能回退到两者都能接受的最低交集——而那个交集可能只有 dev-main 分支。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 用
composer show monolog/monolog查真实可用版本，注意区分dev-main（分支别名）、3.5.0（正式 tag）、3.x-dev（不稳定别名） - 想跳过博弈直接装指定版？写死 tag：
composer require monolog/monolog:3.5.0，别用^3.5或3.5.* - 检查该包的
composer.json是否误设了"version"字段（Packagist 会忽略它，但本地开发时可能误导自己）
PHP 版本或扩展缺失导致 require 中断，错误信息常藏在 -vvv 输出末尾
报错里没明说 PHP 版本不匹配，但实际是根本原因。例如 spatie/laravel-backup 要求 php: ^8.1，而你本地是 8.0.30，Composer 解析时就会静默跳过所有兼容版本，最终报 “no matching package found”。
- 先跑
php -v和php -m | grep -E "(curl|json|mbstring|xml)"，确认基础扩展就位 - 看目标包的
composer.json里"require": {"php": "..."}字段，再比对本地版本 - 若环境确实不匹配，临时用
"config": {"platform": {"php": "8.1.0"}}锁定解析平台版本（仅调试用，上线前必须验证代码真兼容） - 加
-vvv运行composer require，滚动日志最后几行常有 “Skipped package xxx due to platform constraints” 这类提示
国内网络导致超时或 404，镜像源配置不对等于白忙
镜像源配错一个字符，composer require 就会去请求一个不存在的地址，报错却显示 “package not found”，让人误以为是包名错了。
- 查当前源：
composer config -g repos.packagist，正常应输出类似{"type":"composer","url":"https://mirrors.aliyun.com/composer/"} - 阿里云镜像有时不同步新包，尤其刚发布 24 小时内的 tag；临时切回官方源验证：
composer config --unset repos.packagist && composer require vendor/package - 如果镜像源 URL 末尾多了斜杠（如
https://mirrors.aliyun.com/composer//），会导致 404，必须手动修正 - 超时别硬等，设长一点：
composer config -g process-timeout 3000
真正难解的从来不是单个报错，而是多个约束叠加后形成的“隐性死锁”——比如 A 包要求 PHP 8.2 + Laravel 11，B 包要求 PHP 8.1 + Symfony 5.4，而你的 composer.json 里又锁死了 "minimum-stability": "stable"。这种时候，composer prohibits 和 composer why-not 是唯二值得信任的向导。
