报错关键词直接定位问题类型：“Your requirements could not be resolved”是纯依赖冲突，与网络、镜像、权限无关；“Connection refused”等属系统连通失败；“Permission denied”多因sudo污染属主；“file_put_contents”错误常因镜像返回HTML页面；镜像是否生效须以composer diagnose和composer install -vvv输出为准，非composer config显示结果。
看报错关键词直接定位问题类型
别一上来就重装 Composer 或清缓存，先盯住终端里第一行红色报错文字——它已经告诉你该往哪查了。
-
Your requirements could not be resolved：纯依赖冲突，和网络、镜像、权限完全无关。运行composer why-not php:8.3（把 8.3 换成你目标版本）立刻看到哪个包在拦路 -
Connection refused、cURL error 7、Could not fetch https://packagist.org/packages.json：系统级连通失败，不是 Composer 配错了，是 DNS 解析不到、TLS 握手卡死、或被中间人代理静默拦截 -
Permission denied后跟vendor/或composer.lock路径：目录属主被sudo污染过，当前用户没写入权。用ls -ld vendor/ composer.lock看属主，不是chmod 777，而是chown -R $USER:$USER vendor/ composer.lock -
file_put_contents(): Only variables should be passed by reference：这根本不是 PHP 语法错误，是镜像返回了 HTML 页面（比如人机验证），换阿里云源就能过
确认镜像是否真生效，别信 composer config 输出
composer config -g repo.packagist 显示 URL ≠ Composer 正在用它。很多“换源无效”其实是静默 fallback 到官方源，连错误都不报。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 运行
composer diagnose，找到Repo packagist.org:这一行，后面必须是mirrors.aliyun.com类域名，不是packagist.org - 运行
composer install -vvv 2>&1 | head -n 10 | grep Downloading，第一行 URL 才是真实请求地址；如果还是packagist.org，说明镜像没走成 - 检查项目根目录
composer.json是否含"repositories"字段：哪怕只是"repositories": []，全局配置也彻底失效 - 正确命令必须带
-g、composer类型参数、HTTPS 且末尾有/：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
清缓存不是可选项，是必做动作
缓存残留是“换源后仍走旧地址”的头号原因。Composer 会复用失败记录，不删它，重试永远卡在老路径。
- 执行
composer clear-cache（Linux/macOS）或手动删%LOCALAPPDATA%\Composer\cache（Windows） - 删掉
vendor/和composer.lock：前者可能残留旧 autoload.php，后者硬编码了旧 provider 地址，不删它们，Composer 就一直 retry 失败路径 - 切镜像后不执行这两步，90% 的“换源无效”就出在这里
SSL 错误或 TLS 握手失败，根源不在 Composer 配置
报 unable to get local issuer certificate 或 cURL error 60，不是镜像 URL 写错了，是 PHP 的证书链失效或系统时间偏差太大。
- 运行
php --ini找到真实加载的php.ini，在里面设curl.cainfo = "/path/to/cacert.pem"（从 https://www.php.cn/link/5fe4dadcdb001d8566cd20e6d8a20251 下载最新版） - 同时检查
openssl.cafile是否指向同一文件，两个参数必须一致 - 校准系统时间：偏差 >5 分钟就会触发 TLS 校验失败
- CI/宝塔环境常见坑：你在 root 下配的全局镜像，但实际执行的是
www用户，得用sudo -u www composer config -g ...单独配
