报错关键词决定排查路径：如“Connection refused”属网络问题，“Your requirements could not be resolved”需检查PHP版本与依赖约束，“Permission denied”应查目录所有权而非权限数字，换镜像后必须清缓存并验证composer.lock是否更新。
报错关键词直接决定排查路径，不是所有红字都该删 vendor 或重装 PHP——先盯住终端里第一行带冒号的错误信息，它才是真正的线索源头。
看报错里有没有 “Connection refused” 或 “cURL error 7”
这说明请求根本没发出去，和依赖、PHP 版本、扩展全无关，纯网络链路问题。
- 运行
ping packagist.org：返回unknown host就是 DNS 故障，临时换8.8.8.8测试 - 执行
composer config -g repo.packagist：输出必须是完整 JSON，例如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；空、null或仍是https://packagist.org，说明镜像根本没生效 - URL 必须 HTTPS + 末尾带
/：写成https://mirrors.aliyun.com/composer（缺斜杠）会拼出非法路径/composerpackages.json，触发 404 - 换源后必须清缓存：
composer clear-cache，否则旧失败记录还在，重试照样走原地址
报 “Your requirements could not be resolved”
这不是网络或镜像问题，是 Composer 已拿到全部元数据，但在本地找不到满足所有约束的版本组合。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 运行
composer why-not php:8.3（把8.3换成你目标 PHP 版本），直接看到哪个包在拦路，比如laravel/framework v11.0 requires php >=8.2，而你本地是PHP 8.1.28 - 检查
composer.lock里任一包的require.php字段，和php -v输出比对 - 确认
composer.json顶部"config": {"platform": {"php": "8.2.10"}}是否硬写了与实际不符的版本——这个配置优先级高于真实环境 - 别加
--ignore-platform-reqs硬扛：装完大概率运行时报Class not found或mb_strlen()不存在
报 “Permission denied” 写 vendor/ 或 composer.lock
90% 是目录归属权被污染，不是权限数字不够，更不该 chmod 777。
- 报错里带路径的那一行就是线索，例如
file_put_contents(/path/to/vendor/autoload.php): Permission denied→ 问题在vendor/ - 立刻执行
ls -ld /path/to/vendor和ls -ld composer.lock：只要任意一行第一列显示root，就确认是所有权错配 - 修复命令：
sudo chown -R $USER:$USER /path/to/vendor /path/to/composer.lock - 宝塔或 CI 环境要特别注意用户身份：你在终端用
root配的全局镜像，但实际运行的是www用户，得用sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
报 “file could not be downloaded” 或卡在 “Loading composer repositories”
基本是网络链路问题，不是本地 PHP 坏了。Packagist.org 直连在国内几乎不可靠。
- 立刻切阿里云镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/（注意第三参数composer不能省，URL 末尾必须带/） - 删掉
vendor/和composer.lock：composer.lock里硬编码了旧源地址，不清它，换源也白搭 - 验证是否真走了镜像：
composer install -vvv 2>&1 | head -n 10 | grep Downloading，第一行 URL 才是真实请求地址 - Windows 用户还得手动删
%LOCALAPPDATA%\Composer\cache
真正容易被忽略的是：报错前几行红色文字不是结果，而是原因；composer.lock 不只是版本快照，它还锁死了 provider 地址、PHP 平台要求和扩展依赖——哪怕镜像、网络、权限全对，只要里面写的 php: 8.2 而你本地是 8.1，就会静默失败。
