“Connection refused”或“cURL error 7”是系统层网络问题，非Composer配置错误，需检查DNS、代理、防火墙或TLS握手；“Permission denied”主因是目录属主错配而非权限数值，应chown而非chmod；“Could not find package”多因元数据未刷新，需清缓存并确认镜像配置生效；“Allowed memory size exhausted”应调高PHP内存限制而非改代码。
报“Connection refused”或“cURL error 7”说明请求根本没发出去
这类错误不是 Composer 配置错了，而是系统层连不上——DNS、代理、防火墙、TLS 握手任一环节断了都会卡在这儿。
- 先跑
ping packagist.org：返回unknown host就是 DNS 解析失败，立刻换 DNS（比如echo "nameserver 8.8.8.8" | sudo tee /etc/resolv.conf） - 再试
curl -I https://mirrors.aliyun.com/composer/packages.json：如果卡在* Connected to或* TLS handshake，说明出口被拦（企业网/代理/中间人证书） - 临时绕过证书校验只用于验证：加
composer config -g secure-http false和composer config -g cafile /dev/null，但别留着——它会埋安全漏洞
报“Permission denied”写 vendor/ 或 composer.lock，90% 是 owner 错配
不是权限数字不够（比如 755 vs 777），而是目录被 root 占了，普通用户再怎么 chmod 也写不进。
- 看报错路径，比如
file_put_contents(/path/to/vendor/autoload.php): Permission denied→ 直接查ls -ld vendor/ - 如果输出第一列含
root root，确认归属错配 - 修复只用
sudo chown -R $USER:$USER vendor/；chmod -R 777是毒药，CI 会拒收、Git 会报警 - 整个项目都乱了？更省事：
rm -rf vendor/ composer.lock，再用当前用户重跑composer install
报“Could not find package”时，Composer 其实已经连上了，只是元数据没刷新
这个错误几乎从不表示包不存在，而是 Composer 拿到的包列表太旧——镜像没生效、缓存没清、或者项目级 repositories 覆盖了全局配置。
- 运行
composer config -g repos.packagist：输出必须是完整 JSON，如{"type":"composer","url":"https://mirrors.aliyun.com/composer/"}；空或报错说明全局配置失败 - 检查项目根目录
composer.json是否有"repositories"字段（哪怕只是[]）——它会**完全屏蔽**全局镜像 - 删掉对应缓存子目录：
rm -rf ~/.composer/cache/repo/https---mirrors.aliyun.com-composer/，再composer clear-cache - 最后手动 curl 镜像 URL 确认同步状态：
curl -sI https://mirrors.aliyun.com/composer/packages.json | head -1应返回HTTP/2 200
报“Allowed memory size exhausted”，别急着改 php.ini
这是 PHP 进程内存限制被 Composer 触爆，不是代码有 bug。尤其 composer update 在无 composer.lock 时峰值常超 1.5GB，而 CLI 默认只有 128M。
- 临时解法最稳：
php -d memory_limit=-1 composer install（-1表示不限制），或设成2G更安全 -
vendor/autoload.php生成失败也报这错？其实是 dump-autoload 扫描了不该扫的文件——检查是否误把logs/、node_modules/或巨型 JSON 放进了 autoload 路径 - CI/CD 中必须显式调用
php -d memory_limit=2G composer install，否则默认限制会崩 - 长期建议升级到 Composer 2.5+，并设环境变量
COMPOSER_MEMORY_LIMIT=-1，但它不能绕过物理内存不足
真正容易被忽略的是：所有网络类报错（Connection refused、cURL error 7、Content-Length mismatch）都和镜像 URL 是否正确无关，它们发生在 HTTP 请求发起之前；而所有 Permission denied 都和 chmod 无关，只和 chown 是否对路有关。
