checksum mismatch 是 Composer 主动触发的安全熔断，而非网络错误；根本原因是下载包哈希与 composer.lock 中 dist.sha256 不符，必须同步清除 vendor 和 composer.lock 并重装以重建可信锁文件。
checksum mismatch 是安全拦截，不是网络错误
报 checksum mismatch 时，Composer 已经明确拒绝加载包——这不是下载失败或重试能解决的问题。它比网络抖动更严肃：下载的 zip 文件哈希值和 composer.lock 中记录的 dist.sha256 对不上，触发的是主动安全熔断。
常见真实原因包括：
- 国内镜像（如阿里云）尚未同步新版 tag，但你的
composer.lock已锁定新哈希 - 包作者重推了同名 tag（删掉再打），导致旧 lock 文件里的哈希失效
- 私有源返回的 dist URL 和 checksum 与 packagist.org 不一致
- 企业网关或代理篡改了响应体（少见，但真实存在）
别反复 composer install，它不会自动修正哈希——锁文件没变，错误就一直复现。
必须连 composer.lock 一起清，否则无效
只删 vendor 目录毫无意义：composer install 会照着错误的 composer.lock 继续拉包，照样报错。真正有效的清理是“元数据 + 安装物”双清。
操作步骤：
- 先备份：
cp composer.lock composer.lock.bak - 彻底清除：
rm -rf vendor composer.lock（Windows 用rd /s /q vendor & del composer.lock） - 切回官方源保真：
composer config -g --unset repos.packagist（去掉镜像干扰） - 重装生成新锁：
composer install——此时会拉取最新元数据，生成带当前有效哈希的新composer.lock
若必须用镜像，等阿里云同步完成（通常 10–30 分钟），再执行 composer config -g repo.packagist composer 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_DISABLE_CHECKSUM_VERIFY=1 composer install 能跳过哈希比对，但它：
- 在 Composer 2.2+ 已被标记为
deprecated，未来版本会移除 - 不修改
composer.lock，下次不带变量仍会报错 - 不验证包来源，可能拉下被篡改的代码
它只适合本地快速验证是否为校验机制本身导致阻塞，绝不能用于 CI 或生产环境。真正的修复永远落在同步源、重建锁、确认镜像可信这三步上。
镜像源配置错误会导致静默失效或安全降级
写错 composer config -g repo.packagist 命令，结果是“没报错但没生效”，这是最危险的情况。关键三要素缺一不可：
- 键名必须是
repo.packagist（不是repos.packagist，多一个 s 就完全无效） - 中间必须带
composer类型声明：composer config -g repo.packagist composer https://... - URL 必须以
/结尾且为https://，否则请求路径错误，返回 404
验证是否生效：composer config -g repo.packagist 输出必须是完整 JSON 对象，例如：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null 或报错，说明根本没写进去。
更隐蔽的风险是：项目级 composer.json 中的 repositories 字段会直接覆盖全局配置——哪怕只写了一行 {"packagist.org": false}，也会让镜像失效。排查请用 composer config repo.packagist（无 -g）和 composer diagnose。
