答案是dns解析失败、防火墙拦截、代理策略或镜像url错误导致，需先用ping/curl验证连通性，再检查composer config -g repo.packagist输出是否为完整json（含"type":"composer"和末尾带/的https url），并清缓存、排除归属权与项目级repositories干扰。
报“Connection refused”或“cURL error 7”：先别动composer config
这类错误根本不是 Composer 配置问题，而是系统连通失败——DNS 解析失败、防火墙拦截、代理策略生效，或者镜像 URL 拼错了。运行 ping packagist.org，如果返回 unknown host，说明 DNS 已挂，换 8.8.8.8 或 114.114.114.114 才管用。
验证是否真用了镜像：composer config -g repo.packagist 输出必须是完整 JSON，例如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；空、null 或仍显示 https://packagist.org，说明配置压根没写进去。
- 漏掉
-g参数 → 只改了当前项目，换目录就失效 - 键名写成
repos.packagist或repositories.packagist→ Composer 2.x 直接忽略 - URL 缺末尾
/→ 请求路径变成/composerpackages.json，404 - 没加
composer作为 type 值 → 配置被静默丢弃
报“Permission denied”写 vendor/ 或 composer.lock：别 chmod，先 ls -ld
90% 的权限报错不是缺权限，是目录归属错了。比如你曾用 sudo composer install，导致 vendor/ 属主变成 root，而你现在以普通用户运行，自然被拒。
直接看报错里带路径的那一行：file_put_contents(/path/to/vendor/autoload.php): Permission denied → 立刻执行 ls -ld vendor/ composer.lock。如果属主是 root，就用 sudo chown -R $USER:$USER vendor/ composer.lock 修复，而不是盲目 chmod 777。
- 宝塔环境注意：面板默认用
www用户执行命令，你在终端用root配的全局配置它读不到 - Windows 下报
Access is denied生成.bat文件？大概率是杀软拦截，临时关 Windows Defender 实时防护再试 - CI/CD 中（如 GitHub Actions）没有
~/.composer目录，全局配置无效，必须进项目目录跑composer config repo.packagist composer https://mirrors.aliyun.com/composer/
报“Young requirements could not be resolved”：不是冲突，是环境不匹配
这个错误和依赖版本冲突无关，是本地 PHP 版本、扩展或 platform 配置不满足 composer.lock 里已锁定包的要求。比如锁文件里有 monolog/monolog v3.5.0，但它要求 PHP >=8.1，而你本地是 PHP 8.0，就会直接失败。
先运行 composer diagnose，它会明确标出缺失的扩展（如 ext-mbstring、ext-xml）；再检查 composer.json 顶部是否有 "config": {"platform": {"php": "8.2.10"}} 这类硬编码，和实际 php -v 输出不符也会触发该错。
-
--ignore-platform-reqs是临时绕过手段，装出来的包大概率运行时报错，不是解决方案 - CI/CD 脚本中只允许写
composer install --no-dev --optimize-autoloader，禁止出现--ignore-platform-reqs或composer update - 刚 clone 项目就失败？先确认
composer.lock是否已提交到 Git —— 缺失它，install会 fallback 成update，行为完全不可控
卡在 “Loading composer repositories” 或日志不显示镜像域名：-vvv 才是真相
配置看起来对，但 composer install 就是不走镜像？别信 composer config 输出，运行 composer install -vvv 2>&1 | head -n 10 | grep Downloading，第一行 URL 才是真实请求地址。
常见干扰项：项目 composer.json 里只要存在 "repositories" 字段（哪怕只是 "repositories": []），全局镜像就彻底失效——不是优先级低，是直接跳过。
- 临时清掉项目级配置：
composer config --unset repositories（注意没-g） - 换源后必须清缓存：
composer clear-cache；Windows 用户还得手动删%LOCALAPPDATA%\Composer\cache - 删
vendor/和composer.lock再重试——composer.lock里硬编码了旧 provider 地址，不清它，Composer 就一直重试失败路径 - 某些镜像返回 HTML 页面（如人机验证）会导致 JSON decode error，用
curl -I https://mirrors.aliyun.com/composer/packages.json验证必须返回HTTP/2 200
