镜像配置未生效是因为根本没写对或被覆盖：漏斜杠、少composer类型参数、项目级repositories字段存在，三者占报错90%以上；composer config -g repo.packagist输出为空或仍为packagist.org说明配置失败，Composer 2.x静默回退官方源；repo.packagist必须单数，命令须严格三段式（含composer type值和末尾/），验证需输出完整JSON；项目composer.json中只要存在"repositories"键（哪怕{}或[]），全局配置即被跳过；必须清缓存、删vendor和composer.lock后重装，否则仍请求旧源。
镜像配置没真正生效，不是“换源失败”，而是根本没写对或被覆盖了——漏斜杠、少composer类型参数、项目级repositories字段存在，这三类问题占全部报错的90%以上。
composer config -g repo.packagist 输出为空或仍是 packagist.org
说明配置命令压根没写成功，Composer 2.x 静默忽略错误，直接 fallback 回官方源。
-
repo.packagist必须是单数形式，写成repos.packagist或repositories.packagist都会失效 - 命令必须严格三段式：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/——中间composer是 type 值，不能省；URL 必须 HTTPS 且末尾带/ - 执行后立刻验证：
composer config -g repo.packagist输出应为完整 JSON，形如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}，否则重配
项目根目录 composer.json 含 repositories 字段
只要存在"repositories"键（哪怕只是{}或[]），全局镜像配置就彻底失效，不是优先级低，是直接跳过。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 检查方法：
grep -o '"repositories":' composer.json，有输出即被屏蔽 - 临时解决：
composer config --unset repositories（注意不加-g） - 长期方案：进项目目录运行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加-g），它会自动合并进composer.json的repositories对象中
缓存没清，composer.lock 没删
Composer 会优先读本地缓存和composer.lock里硬编码的旧 provider 地址，即使镜像已配对，它仍会反复请求 packagist.org 并失败。
- 必须执行：
composer clear-cache（Windows 还需手动删%LOCALAPPDATA%\Composer\cache） - 必须删除：
rm -rf vendor/ composer.lock——composer.lock里存着旧源路径，不清掉就永远重试失败地址 - 验证是否真走镜像：
composer install -vvv | grep Downloading，第一行 URL 域名必须含mirrors.aliyun.com
系统时间偏差或 CA 证书过期
报 SSL certificate problem: certificate has expired 或卡在 Loading composer repositories，大概率不是镜像问题，而是本地时间快/慢超 2 分钟，或 PHP 的 openssl.cafile 指向了停更的证书包。
- Linux/macOS：运行
timedatectl status，若System clock synchronized: no，执行sudo timedatectl set-ntp true并重启systemd-timesyncd - Windows：管理员运行
w32tm /resync，失败则先net start w32time，再指定可靠源w32tm /config /syncfromflags:manual /manualpeerlist:"time.nist.gov" - 查证书路径：
php -r "print_r(openssl_get_cert_locations());"，下载最新cacert.pem（https://www.php.cn/link/5fe4dadcdb001d8566cd20e6d8a20251），更新php.ini中openssl.cafile和curl.cainfo
最容易被忽略的是composer.lock——它不像缓存那样能被clear-cache清理，也不像 vendor 目录那样明显可见，但只要它还在，Composer 就会固执地按旧路径去请求，无论你配了多少遍新镜像。
