报错“Permission denied”写vendor/或composer.lock，95%是目录被sudo污染致属主为root，应执行sudo chown -R $USER:$USER vendor/ composer.lock修复，禁用sudo composer install和chmod 777。
报错里带“Connection refused”或“cURL error 7”
说明请求根本没发出去，不是 Composer 配置错了，是系统连不上网。别急着改 composer.json 或换镜像——先验证基础连通性。
- 运行
ping packagist.org：如果返回unknown host，就是 DNS 解析失败，该改/etc/resolv.conf（Linux/macOS）或网络适配器 DNS（Windows），设成8.8.8.8 - 运行
curl -v https://mirrors.aliyun.com/composer/：卡在* Connected to是 TCP 层不通；卡在* TLS handshake是证书或代理问题；能拿到HTTP/2 200才算通 - 企业内网或 Docker 场景下，
localhost指的是容器自己，想连宿主机得用http://host.docker.internal:8080（Linux 还要加--add-host=host.docker.internal:host-gateway）
报错里有“Permission denied”写 vendor/ 或 composer.lock
95% 是目录属主被 sudo 污染过，不是权限不够，是 Composer 用当前用户去写 root 创建的文件，系统直接拒绝。
- 看报错路径：
file_put_contents(/path/to/vendor/autoload.php): Permission denied→ 问题就在vendor/目录 - 运行
ls -ld vendor/ composer.lock ~/.composer，如果属主是root，就证实了 - 修复命令：
sudo chown -R $USER:$USER vendor/ composer.lock（Linux/macOS）；Windows 用户删掉vendor和composer.lock重来即可 - 切记：以后别用
sudo composer install，哪怕提示“permission denied”也先查属主
报错是“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 换成你目标版本），直接看到哪个包在拦路，比如输出laravel/framework v10.42.0 requires php ^8.1，但另一个包锁死了php: ^7.4 - 检查
composer.json里有没有写死版本号，例如"monolog/monolog": "2.9.0"，而新包要求^3.0，两者无交集 -
composer install --ignore-platform-reqs只是绕过校验，不能上线；真正要解决，得调低 PHP 版本要求，或升级拦路包
切了镜像还报 404、SSL 错误或 JSON decode error
不是镜像挂了，是你本地缓存和 lock 文件里还存着旧地址，Composer 拿着旧路径去新源上找不存在的东西。
- 先清缓存：
composer clear-cache；Windows 用户还得手动删%LOCALAPPDATA%\Composer\cache - 删掉
vendor/和composer.lock——composer.lock里硬编码了旧 provider 地址，不删它，重试照样走失败路径 - 验证镜像是否真可用：
curl -I https://mirrors.aliyun.com/composer/packages.json必须返回HTTP/2 200且响应体是合法 JSON（含顶层packages键） - 如果 curl 返回 HTML 页面（比如人机验证），说明该镜像不适合自动化场景，换腾讯云或 Laravel China 源
复杂点在于：错误关键词看似相似，但根因可能跨网络、权限、依赖逻辑三个完全不同的层。盯住报错里第一个明确路径或 URL 的那行，它才是真实线索。
