Composer install 报错 “Your requirements could not be resolved” 怎么办
这个错误本质是依赖冲突，不是网络或权限问题。Composer 尝试安装时发现 composer.json 里声明的包版本和已有的 lock 文件、全局已装包、PHP 版本限制之间无法同时满足。
- 检查
php -v和composer show php是否一致，很多报错实际源于本地 PHP 版本低于require.php声明的最低版本 - 运行
composer why-not vendor/package:version（比如composer why-not monolog/monolog:^3.0）直接定位哪个包在阻塞升级 - 不要盲目删
composer.lock：它记录了精确版本，删了可能导致线上和本地行为不一致；真要重算，先用composer update --dry-run预览变更 - 如果项目用了私有仓库，确认
auth.json里的 token 仍有效，过期 token 会伪装成“无法解析依赖”
Composer update 卡在 “Loading composer repositories” 或超慢
这通常是默认源（packagist.org）在国内 DNS 解析或连接不稳定导致的，不是 Composer 本身慢。
- 优先换国内镜像源：
composer config -g repo.packagist composer <a href="https://www.php.cn/link/dc02ae8025eef0ecde61b00bb780abdb">https://www.php.cn/link/dc02ae8025eef0ecde61b00bb780abdb</a>（注意：该地址已停用）→ 改用composer config -g repo.packagist composer <a href="https://www.php.cn/link/a7e3a8dde26508f6ace8f51f4634197b">https://www.php.cn/link/a7e3a8dde26508f6ace8f51f4634197b</a>或更稳的<a href="https://www.php.cn/link/1569ae888190eb8c53b218b0d529e1e9">https://www.php.cn/link/1569ae888190eb8c53b218b0d529e1e9</a> - 避免在 CI 环境中反复切源：CI 镜像通常已预配置阿里云源，硬写
config反而触发额外 DNS 查询 - 关闭 HTTPS 验证（仅限调试）：
composer config -g secure-http false，但生产环境禁用——某些企业防火墙会拦截 SNI 请求，关掉后可能绕过卡顿 -
composer install比composer update快得多，只要composer.lock存在且没改composer.json的 require 段，就别用 update
require-dev 包被误装进生产环境
composer install 默认会装 require-dev，但线上通常不需要 PHPUnit、PHPStan 这类工具，既拖慢部署又增大攻击面。
- 部署时加
--no-dev参数：composer install --no-dev --optimize-autoloader - 确认
COMPOSER_NO_DEV环境变量未被意外设为 false（某些 Dockerfile 里写了ENV COMPOSER_NO_DEV=0，这会让 --no-dev 失效） -
autoload-dev里的路径不会被自动加载，但包本身仍会被解压到vendor/；如果连文件都不想出现，只能靠scripts+post-install-cmd手动删目录（不推荐，易出错）
PHP 8.2+ 下 composer create-project 报错 “Declaration of … must be compatible with …”
这是 Composer 自身（v2.2.x 之前）与新版 PHP 的反射机制不兼容所致，不是你项目代码的问题。
- 升级 Composer 到最新稳定版：
composer self-update（确保 ≥ v2.5.0） - 若公司内网禁止直连 GitHub，用离线安装包手动替换：
php -r "copy('<a href="https://www.php.cn/link/e910517884e11c8a741c3b1da823f47e">https://www.php.cn/link/e910517884e11c8a741c3b1da823f47e</a>', 'composer-setup.php');"→ 再执行安装脚本 - 临时降级 Composer（不推荐）：
composer self-update 2.4.4，但 2.4.x 在 PHP 8.3 下也会出同样问题，只是延迟暴露
有些项目依赖老旧插件（比如 hirak/prestissimo），它已被 Composer 2 原生支持，继续启用反而引发 autoload 冲突——删掉 composer.json 里的 prestissimo 相关配置即可。
