报错关键词直接决定排查方向：”your requirements could not be resolved“属环境不匹配或锁文件前提失效；”file could not be downloaded“或卡在loading repositories是网络问题；”permission denied“多因sudo污染属主；”failed to open stream“或curl error 7系dns或连接拦截。
报错关键词直接决定排查方向
看到错误信息第一眼就该盯住关键词，不是翻日志全文，而是抓核心词定位问题类型：Your requirements could not be resolved 是环境不匹配或锁文件前提失效；file could not be downloaded 或卡在 Loading composer repositories 基本是网络链路问题；Permission denied 写 vendor/ 或 composer.lock，八成是目录属主被 sudo 污染了；failed to open stream 或 cURL error 7 说明 DNS 解析失败或 TCP 连接被拦，和 Composer 配置无关。
镜像配置写错，Composer 就安静退回官方源
国内用户换源失败，90% 不是因为镜像挂了，而是配置项写错——它不会报错，只默默 fallback 到 https://packagist.org。必须同时满足三个硬条件：
-
repo.packagist是唯一合法键名，repos.packagist、repositories.packagist全无效 - 命令末尾必须显式传入
composer作为 type 值：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - URL 必须 HTTPS 且结尾带
/：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（拼路径变成/composerpackages.json，404）
验证是否真生效：运行 composer config -g repo.packagist，输出必须是完整 JSON 对象，比如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null 或仍返回官方地址，说明没写对。
项目级配置会彻底屏蔽全局镜像
只要项目根目录 composer.json 里有 "repositories" 字段（哪怕只是 "repositories": []），全局配置就完全失效——不是优先级低，是直接跳过。更麻烦的是权限场景：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 宝塔默认用
www用户执行命令，你在终端用root配的全局镜像，www根本读不到 - CI runner（如 GitHub Actions）或 Docker 容器里可能压根没有
~/.composer目录
推荐做法：进项目根目录，运行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加 -g）。它会自动合并到 composer.json 的 repositories 字段中，key 固定为 "packagist"。如果原文件是 "repositories": []，需先手动改为 "repositories": {} 再执行，否则报错。
清缓存、删 lock、重试前先看真实请求地址
切镜像后仍卡住或报 SSL 错误，不是镜像不可用，而是缓存残留或 composer.lock 里硬编码了旧 provider 地址。关键动作不是反复重试：
- 运行
composer install -vvv 2>&1 | head -n 10 | grep Downloading，第一行 URL 才是真实请求地址——别只信composer config输出 - 先执行
composer clear-cache；Windows 用户还得手动删%LOCALAPPDATA%\Composer\cache - 删掉
vendor/和composer.lock，再重跑composer install - 手动验证镜像可用性：
curl -I https://mirrors.aliyun.com/composer/packages.json必须返回HTTP/2 200；若返回 HTML 页面（如人机验证），说明该镜像不适合自动化场景
真正容易被忽略的是：SSL 错误（unable to get local issuer certificate）往往不是镜像问题，而是 PHP 的 curl.cainfo 指向了过期 CA 证书文件。运行 php --ini 找到真实加载的 php.ini，配好 curl.cainfo = "/path/to/cacert.pem"，然后重启终端或服务。
