必须同步删除vendor、composer.lock和缓存，并切回官方源重装，因“hash verification failed”源于composer.lock中硬编码的dist.sha256与新下载ZIP包不一致，仅清缓存无效。
“hash verification failed”不是清缓存就能解决的错误——它本质是 composer.lock 里硬编码的 dist.sha256 和你刚下载的 ZIP 包不一致，必须同步清理 vendor、composer.lock 和缓存，并用可信源重生成锁文件。
为什么 composer clear-cache 完全无效
这个命令只删 ~/.composer/cache/（Linux/macOS）或 %APPDATA%\Composer\Cache（Windows）里的 ZIP 和元数据，但 composer.lock 中记录的哈希值完全不受影响。安装时 Composer 仍会拿旧哈希去比对新包，差一个字节就直接报错。
- CI 环境中若
COMPOSER_CACHE_DIR被挂载到 NFS 或持久卷，clear-cache可能根本没清到实际路径 - 即使清完缓存，再跑
composer install，它仍会读旧composer.lock，继续失败 - Windows 用户常漏掉
del composer.lock，必须配对执行：rd /s /q vendor & del composer.lock
如何确认当前镜像源是否真生效
很多人以为运行过 composer config -g repo.packagist https://mirrors.aliyun.com/composer/ 就设好了，其实配置可能静默失效。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 查全局配置：运行
composer config -g repo.packagist，输出必须是完整 URL 或 JSON 对象，如{"type":"composer","url":"https://mirrors.aliyun.com/composer/"}（注意末尾斜杠） - 检查项目级覆盖：运行
composer config repositories，如果出现"type": "vcs"或自定义 URL，全局镜像会被绕过 - 手动验证通断：
curl -I https://mirrors.aliyun.com/composer/packages.json，必须秒回HTTP/2 200；返回 HTML、301 或卡住，说明镜像服务异常
真正有效的修复流程（顺序不能乱）
目标是让 Composer 抛弃所有旧上下文，从同一时刻快照拉取元数据，重新生成带当前有效哈希的 composer.lock。
- 先备份：
cp composer.lock composer.lock.bak - 切回官方源保真：
composer config -g --unset repos.packagist.org（Composer 2.5+ 已废弃repo.packagist键名） - 清缓存：
composer clear-cache，确认输出含Clearing cache (all) - 删干净：
rm -rf vendor composer.lock（Windows 用rd /s /q vendor & del composer.lock） - 重装生成新锁：
composer install——此时会拉取完整packages.json，所有dist.sha256都来自同一时刻快照
CI/CD 流水线里报错往往不是本地环境的问题，而是构建节点上的缓存路径、系统时间、镜像源配置三者没对齐；尤其要注意 composer.lock 是否被意外提交了旧版本，或构建前未强制清除。
