Composer install 报“Could not find package”本质是未下载到 packages.json，需验证镜像可用性、URL格式、DNS/TLS、配置生效状态及缓存污染，并执行清空缓存、vendor和lock文件三步操作。
composer install 报 “Could not find package” 或卡在 metadata 阶段
不是包真不存在，而是 Composer 根本没拿到 packages.json —— 它连镜像的索引文件都没拉下来，后续所有解析、依赖求解都无从谈起。常见表现是命令长时间静默、composer install -vvv 输出里压根不出现 Downloading.*.json。
- 先验证镜像基础可用性：
curl -I https://mirrors.aliyun.com/composer/packages.json必须返回HTTP/2 200和Content-Type: application/json；若返回404、HTML 页面或空响应，说明镜像未同步或 URL 错误 - 确认镜像 URL 是 HTTPS 且结尾带
/：写成https://mirrors.aliyun.com/composer（缺斜杠）会导致 Composer 拼出非法路径/composerpackages.json，必然 404 - DNS 或 TLS 层失败也会表现为“找不到”：运行
ping packagist.org看是否能解析；curl -v https://mirrors.aliyun.com/composer/看卡在* Connected to还是* TLS handshake - 别信
composer config -g repo.packagist的输出——它只告诉你“写了什么”，不等于“正在用什么”。真正生效的得看composer diagnose输出中Repo packagist.org:那一行
重置镜像连接：删缓存 + 删 lock + 强制重拉
换源后仍报 hash 不匹配、包找不到、JSON decode error，90% 是本地残留了旧元数据和旧锁文件。镜像只改下载路径，不兼容旧 composer.lock 里硬编码的 provider 地址和哈希值。
- 必须执行三步清空：
composer clear-cache（清全局元数据缓存）、rm -rf vendor/ composer.lock（删掉已安装包和锁文件）、再跑composer install（不是update） - Windows 用户注意：
composer clear-cache不会自动清理%LOCALAPPDATA%\Composer\cache，需手动删掉该目录下的repo子目录 - 如果项目
composer.json里有"repositories"字段（哪怕只是空数组[]），全局镜像配置就完全失效。临时解决：运行composer config --unset repositories（不加-g） - 某些 CI/CD 或宝塔环境，你用
root配的全局镜像，但实际执行的是www用户，得用sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
为什么 composer config -g repo.packagist 看起来成功却没生效
Composer 2.x 对配置格式极其严格，错一个字符就静默 fallback 到 https://packagist.org，不报错也不提醒。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 键名必须是
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/✅ - 验证是否真写进去了：
composer config -g repo.packagist输出必须是完整 JSON 对象，例如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；若为空、null或仍是官方地址，说明根本没写成功
调试时看真实请求地址，别看配置输出
composer install -vvv 日志里第一行 Downloading 的 URL 才是你实际连的地址。配置可能被覆盖、缓存可能污染、DNS 可能劫持——只有日志不会说谎。
- 快速提取真实请求：
composer install -vvv 2>&1 | grep "Downloading" | head -n 1 - 如果输出里是
https://packagist.org/或其他非预期域名，说明镜像没走通，立刻检查composer diagnose和项目级repositories字段 - CI/CD 中建议加
COMPOSER_CACHE_DIR=$(mktemp -d)，避免上一次构建的脏缓存污染本次 - 某些错误（如
file_put_contents(): Only variables should be passed by reference）其实是镜像返回了 HTML 错误页或 BOM 头，不是 PHP 语法问题——换阿里云/腾讯云源即可
最常被忽略的一点：镜像同步有延迟，新发布的包可能要等 5–30 分钟才出现在国内镜像中。别急着怀疑配置，先用 curl -sSL "https://mirrors.aliyun.com/composer/p2/vendor/package.json" 直接测目标包是否存在。
